home *** CD-ROM | disk | FTP | other *** search
/ LSD Docs / LSD Docs.iso / FILEZ / lsd34.dms / lsd34.adf / AmiBack2.doc.pp / AmiBack2.doc
Text File  |  1990-09-13  |  120KB  |  2,630 lines

  1.                                   AMI-BACK
  2.  
  3.                 The Ultimate Hard Disk Backup and Scheduling
  4.               Utility for the Commodore Amiga Personal Computer
  5.  
  6.                                 USER'S GUIDE
  7.  
  8.                    Moonlighter Software Development, Inc.
  9.                           Copyright 1990,1991,1992
  10.  
  11.  
  12.  
  13.                           Another doc by Baser Evil
  14.  
  15.  
  16.  
  17.                                   Ami-Back
  18.                         The Ultimate Backup Utility
  19.  
  20.                                   Program
  21.                                 Gary Holland
  22.                               Michaeel Mounier
  23.  
  24.                                    Manual
  25.                                   Hap Aziz
  26.                                 Gary Holland
  27.  
  28.  
  29.  
  30. Copyright, Trademarks, Software License Agreement, Limited Warranty,
  31. Support and Upgrade Policy skipped because who cares for it.....
  32.  
  33.  
  34.  
  35. Credits, Special Thanks, blah blah blah skipped.... begin manual....
  36.  
  37.  
  38.  
  39. TABLE OF CONTENTS
  40. ----------------------------------------------------------------------------
  41.  
  42. Copyright                                 ii
  43. Trademarks                                ii
  44. Software License Agreement                ii
  45. Limited Warranty                          ii
  46. Support and Upgrade Policy                ii
  47. Credits                                   iii
  48. Introduction                              1
  49. Package Contents                          3
  50. System Requirments                        5
  51. Installation                              7
  52. The Zen of Hard Disk Maintenance          9
  53. Overview of Features/Capabilities         11
  54. Program Configuration                     13
  55. Backup Configuration                      19
  56. Restore Configuration                     29
  57. Media Requirements                        41
  58. Scheduler Configuration                   43
  59. Running Ami-Back                          49
  60. Performing Backups                        51
  61. Performing Restores                       59
  62.      Compare Mode                         64
  63. Running Ami-Sched                         67
  64. Performing Backups from the Shell         61
  65. Other Features                            62
  66.      Online Help                          71
  67.      AREXX                                72
  68. Appendix I - Question and Answer          75
  69. Appendix II - Hardware Configurations     77
  70. Appendix III - Tips and Tricks            79
  71. Appendix IV - Error Messages              81
  72. Index                                     83
  73.  
  74.  
  75.  
  76. Introduction
  77. ----------------------------------------------------------------------------
  78.  
  79. Congratulations on your purchase of Ami-Back by Moonlighter Software
  80. Development, Inc. Ami-Back is the most powerful and full-featured hard disk
  81. backup program available for the Commodore Amiga computer. Ami-Back will
  82. back up and restore your hard drive quickly and more conveniently than any
  83. other backup program on the market. Not only that, but Ami-Back gives you
  84. the ability to restore data from crashed hard drives - without the need for
  85. any additional hard disk tools or utilities programs!
  86.  
  87. Hard drive errors and data corruption may happen any time even to the most
  88. careful computer user, and when this happens the results can be disastrous.
  89. Ami-Back allows you to protect the valuable data on your hard drive from
  90. loss. By taking the drudgery out of backing up your data, Ami-Back ensures
  91. that you won't put off the task until it's too late!
  92.  
  93.                                     -1-
  94.  
  95. PACKAGE CONTENTS
  96. ----------------------------------------------------------------------------
  97.  
  98.  o Users Guide
  99.  o Registration Card (Be sure to send this in if you want support and
  100.    notification of future upgrades!)
  101.  o Program Disk: Contents of Disk - Your original Ami-Back disk contains
  102.    both the 1.3 version and the 2.0 version of the program. On the disk you
  103.    will find the following:
  104.  o ami-back13 - The version of Ami-Back for AmigaDOS 1.3. This version
  105.    will run under AmigaDOS 2.0.
  106.  o ami-back20 - The version of Ami-Back for AmigaDOS 2.0. This version will
  107.    only run under AmiaDOS 2.0 version 2.04 or higher.
  108.  o ami-sched13 - The version of Ami-Sched for AmigaDOS 1.3.
  109.  o ami-sched20 - The version of Ami-Sched for AmigaDOS 2.0.
  110.  o hd-install - The installation program for Ami-Back and Ami-Sched.
  111.  o README! - A text file that lists the changes and enhacements to the
  112.    program that were made after this manual went to press. Be sure
  113.    to read this file for important information. 
  114.  o The following files are required for the operation of Ami-Back:
  115.  
  116.               amiback.guide-------
  117.                                  |--- Workbench 2.0
  118.               amigaguide.library--
  119.  
  120.               asl13.library-------
  121.                                  |--- Workbench 1.3
  122.               gadtools13.library--
  123.  
  124.                                     -3-
  125.  
  126. SYSTEM REQUIREMENTS
  127. ----------------------------------------------------------------------------
  128.  
  129. Ami-Back20 requires any Amiga computer operating under AmigaDOS 2.0 or
  130. greater (Kickstart version 37.xxx/WB v2.04 or greater) to run. Minimum
  131. memory required is 512 kilobytes, although more memory may be required for
  132. systems with extremely large numbers of files. Ami-Back13 requires Kickstart
  133. version 1.1 or greater.
  134.  
  135.                                     -5-
  136.  
  137. INSTALLATION
  138. ----------------------------------------------------------------------------
  139.  
  140. The Ami-Back disk is not copy protected in any way. This allows you to make
  141. your archival copy in oredr to protect your investment. However, Ami-Back is
  142. personalized and will not run unless you provide your name and program
  143. serial number during the installation process. Feel free to spread the word
  144. about the program, but please do not spread the disk!
  145.  
  146. If an earlier version of Ami-Back is already installed on yoru computer and
  147. you are installing this version as an update, you must delete the old
  148. S:AMI-BACK.CONFIG file prior to running the new version of the program. This
  149. will be handled properly as long as you use the provided Installation
  150. program.
  151.  
  152. Step 1: Immediately make a backup copy of the Ami-Back program disk, and put
  153. the original away in a safe place. (If you are unfamiliar with the Amiga
  154. Workbench operating enviornment, or if you require more information on how
  155. to make copies of your floppy disks, please consult the AmigaDOS manual that
  156. came with your computer.)
  157.  
  158. Step 2: Insert the program disk into a floppy dive and open the disk (by
  159. double clicking the disk icon) from Workbench.
  160.  
  161. Step 3: Once the disk contents are displayed on your screen, you will see an
  162. icon named "Install Ami-Bak." This is the hard disk installation program
  163. that will place Ami-Back20 or Ami-Back13 and the associated files on your
  164. hard disk drive. Double click on this icon in order to execute the
  165. installation program.
  166.  
  167. Step 4: The Ami-Back/Ami-Sched Installation Program window will appear on
  168. your screen. Here you must Set Installation Mode by selecting the NOVICE
  169. USER, INTERMEDIATE USER, or EXPERT USER gadget. In the Novice User mode, the
  170. installation program will complete the installation automatically with no
  171. user inetraction required. The installation program will detect whether you
  172. have Workbench 1.3 or Workbench 2.0 running on your system and install the
  173. appropriate version of Ami-Back. (In Expert User By default, the
  174. installation progran will create a directory WORK:AMI-BACK and install
  175. Ami-Back there, and the support files will be installed in their proper
  176. locations (the library files will be placed in the LIBS: directory and
  177.  
  178.                                     -7-
  179.  
  180. the amiback.guide file will be placed in the S: directory. The Expert User
  181. mode will allow you to control the installation process at every step,
  182. deciding exactly where you wish each file to be installed. Click on the
  183. PROCEED WITH INSTALL gadget to continue or the ABORT INSTALL gadget to
  184. end the process.
  185.  
  186. Step 5: If you selected the Intermediate or Expert User mode for the
  187. installation, after you select the PROCEED WITH INSTALL gadget you will be
  188. able to select between INSTALL FOR REAL and PRETEND TO INSTALL options, and
  189. you will be able to log all actions to PRINTER, LOG FILE, or NONE. Make your
  190. selections then select PROCEED or ABORT INSTALL.
  191.  
  192. Step 6: Next you will be asked to select the destination for Ami-Back (if
  193. you are in Intermediate User or Expert User mode).
  194.  
  195. Step 7: Once the installation is complete, you will be prompted to enter
  196. your name and program serial number. You must perform the personalization
  197. segment of the installation, otherwise Ami-Back will not work.
  198.  
  199. Ami-Back is now installed on your Amiga hard disk drive and is ready to be
  200. configured!
  201.  
  202.                                     -8- 
  203.  
  204. THE ZEN OF HARD DISK MAINTENANCE
  205. ----------------------------------------------------------------------------
  206.  
  207. You should consider regularly performing backups to be one of the most
  208. important kinds of system maintenance. Once you take this idea to heart, you
  209. will prevent inconvenient, exasperating, and potentially disastrous losses
  210. of data. (If you do learn this lesson the "hard way," don't feel too bad -
  211. almost all computer users have experienced losing data after having
  212. neglected to perform routine backups. Think of the experience as an
  213. "initiation" into the world of serious computing; hopefully it won't be too
  214. bad!)
  215.  
  216. Ami-Back was written with the multitasking ability of the Amiga in mind.
  217. While configuring your options, for example, it is entirely possible for you
  218. to be performing many other tasks with your Amiga. (As an interesting side
  219. note, this manual was authored while Ami-Back was running - which made it an
  220. easy task to write about its features!) However, when actually performing
  221. backups, we recommend that you run Ami-Back as a single task. The reason for
  222. this is simple: It is quite possible to run a task concurrently with
  223. Ami-Back that updates files, and if the updating occurs during the backup
  224. process, the file may be updated after it was backed up. In this respect you
  225. will not be guaranteed a completely accurate backup.
  226.  
  227. How often you should perform backups will vary depneding on how much you use
  228. your computer. The more that files on your hard drive are added, updated,
  229. altered, or deleted the greater the need to back up your data. For some
  230. users, performing a backup only once a month is perfectly sufficent.
  231. Computers that are used heavily (such as machines on networks, machines
  232. running bulletin board services, machines in business enviornments, etc.)
  233. should be backed up more often. A recommended backup schedule for such
  234. machines would be to perform complete backups at least once a month with
  235. incremental backups performed weekly.
  236.  
  237. Keep in mind that these recommendations are only general guidelines based on
  238. a few rules of thumb. Only you can accuretly determine your actual backup
  239. needs. The most important thing is that you should be consistent with your
  240. backup duties. Set a shedule, and stick to it!
  241.  
  242.                                     -9-
  243.  
  244. After taking the time to perform your backup, be sure to keep the media in a
  245. safe place. That means store the media someplace away from your computer!
  246. Altough it is unlikely that some external event could take place to damage
  247. your computer and hard drive, accidents do happen from time to time! Your
  248. backups won't do you much good if they were stored right next to your
  249. computer.... and also ruined by whatever accident that happened. A water
  250. sprinkler going off in the workplace could spell disaster. So be sure to
  251. store yoru backup media some distance from your computer.
  252.  
  253. Be sure to maintain multiple backup copies. It is never a good practice to
  254. perform your backups with the only copy of your backup media. If, for
  255. example, something happened (a power surge, perhaps) during the backup
  256. process, it would be possible for your hard drive to be damaged.... as well
  257. as your only backup copy.
  258.  
  259. Remember: If your data is important to you, it is important to take good
  260. care of it by backing your hard disk up regularly.
  261.  
  262.                                     -10-
  263.  
  264. OVERVIEW OF FEATURES/CAPABILITIES
  265. ----------------------------------------------------------------------------
  266.  
  267. Ami-Back gives you complete control over the hard disk backup and restore
  268. process. Here is an outline of Ami-Back's wealth of features:
  269.  
  270.   o The Backup Option allows you to select the sources from any of the
  271.     available devices, and you may select destinations from floppy
  272.     drives (regular or high desnity), tape drive (streaming tape or DAT),
  273.     AmigaDOS files, or any mounted partition.
  274.   o The kinds of backups you can perform are Complete, Selective, Recovery,
  275.     and Image (which allows you to backup non-AmigaDOS partitions such as
  276.     AMAX, UNIX, or MS-DOS).
  277.   o The 911-Recovery mode actually recovers lost data from corrupted hard
  278.     drives! You don't have to get a seperate hard disk utility to do this.
  279.   o A filter system allows you to backup or restore just files you need.
  280.   o Through the Compare option you can verify your backed-up data file by
  281.     file, checking for any differences such as filesize or datestamp,
  282.     for example.
  283.   o Ami-Back can compress your data, and there will be no loss of speed
  284.     during backup. In fact, on accelerated machines there is a noticeable
  285.     speed increase when performing backups to floppy disks.
  286.   o You can label your backups and create complete backup catalogs.
  287.   o You can specify the location for your backup index files. If you
  288.     lose your index, Ami-Back can rebuild it for you.
  289.   o If you want to make sure that no one else can get to your data,
  290.     you can password protect your backups.
  291.   o Online Help for the major functions is available through the
  292.     AmigaGuide interface. Simply position the mouse pointer over the
  293.     desired gadget and press the HELP key for imformation.
  294.   o The built-in scheduler, Ami-Sched, allows you to completely
  295.     control Ami-Back automatically. Ami-Back will perform backups
  296.     without any user interaction.
  297.  
  298.                                     -11-
  299.  
  300.   o You can communicate with Ami-back via AREXX.
  301.   o Keyboard equivalents allow you to select the command or option
  302.     you desire by pressing the appropriate key rather than by using the
  303.     mouse. The keyboard equivalent for a command is the letter that is
  304.     underscored.
  305.  
  306.                                     -12-
  307.  
  308. PROGRAM CONFIGURATION
  309. ----------------------------------------------------------------------------
  310.  
  311. To start Ami-Back from Workbench, simply enter the directory in which you
  312. installed Ami-Back, and click the program icon. (Shell users may activate
  313. the program by entering AMI-BACK20 or AMI-BACK13 from the proper directory
  314. path location.) The main program screen appears, giving you the options of
  315. performing a BACKUP, performing a RESTORE, selecting the SCHEDULER or
  316. selecting QUIT to exit the program.
  317.  
  318. When you first use Ami-Back, you will want to configure it to fit your
  319. backup and restoration needs. Press the right mouse button to obtain the
  320. menu bar on the Ami-Back main screen. Three menu headings will be displayed:
  321. PROJECT, PREFERENCES, and TAPE. Under the PREFERENCES heading there are
  322. three subheadings that allow you to set the Backup, Restore, or Program
  323. configuration options. Select PROGRAM CONFIGURATION. The Ami-Back Program
  324. Configuration screen will appear.
  325.  
  326. Here you will be able to specify where the files needed by the program are
  327. to be kept as well as some of the basic program attributes. The "Ami-Back
  328. Program Path" displayed is **NOT VALID PATH**, so you must enter the full
  329. path including the program name here. Ami-back assigns a default
  330. location of the S: directory to the "Log File Path" and the "Index
  331.  
  332.                                     -13-
  333.  
  334. File Path." In addition to being assigned to the S: directory, the "Backup
  335. Filter Path" and the "Restore Filter Path" are named so that you can have
  336. more than one of each type of filter.
  337.  
  338. Ami-Back is quite flexible and will allow you to specify any locations you
  339. wish for these files. Just keep in mind that over the course of time as you
  340. can use the program, some of these files will become larger. Therefore, be
  341. sure that you specify locations for these files where space is and will
  342. continue to be available.
  343.  
  344. AMI-BACK PROGRANM PATH (INCLUDE PROGRAM)
  345.  
  346. This is the location of the Ami-Back program. The Ami-Sched scheduler
  347. program looks here to determine the location of Ami-Back, so do not move
  348. Ami-Back without also updating this information. Specifying a full path
  349. including the program name allows you to rename the backup program. For
  350. example, if you wish to rename the program AB and place it in the WORKSTUFF
  351. directory of your HDRIVE: partition, specify the full path as
  352. HDRIVE:WORKSTUFF/AB.
  353.  
  354.                                     -14-
  355.  
  356. LOG FILE PATH (DIRECTORY ONLY)
  357.  
  358. This is where the AMI-BACK.LOG file is kept. Entries are made to this file
  359. whenever you start or abort Ami-Sched and whenever the backup program is run
  360. as a background task from Ami-Sched (see the section on the scheduler) or if
  361. it is used from an AREXX server. Also, any errors which occur during backup
  362. and cannot be displayed during the backup process are automatically added to
  363. this file.
  364.  
  365. The length of the log file will increase with continued use of Ami-Sched. If
  366. you wish to limit the length of this file, you must do so through the use of
  367. a text editor. (The program ED supplied on your Workbench disk is sufficent
  368. for this task; though you may use the text editor of your choice.) The most
  369. recent entries are made at the end of the log file, so make deletions from
  370. the beginning of the file to remove older information. This will maintain
  371. the most accurate record of Ami-Back's activity.
  372.  
  373. When you run Ami-Back as a background task (i.e., no windows), any updates
  374. the program makes will be placed into the log file automatically. Also, you
  375. may delete the entire log file without affecting the operation of the
  376. program. Ami-Back will recreate a log file whenever one is needed.
  377.  
  378. INDEX FILE PATH (DIRECTORY ONLY)
  379.  
  380. The files created at the end of all backups are kept here. The template for
  381. these files is [PARTITION]-[BACKUP TYPE]-[DEVICE TYPE]-[DATE].IDX.(SEQUENCE
  382. NUMBER). For example, a complete backup of partition DH2: made to a tape
  383. drive and performed on April 15, 1992, would generate an index file named
  384. DH2-C-T-04_15_92.IDX. Due to the file length limitation of AmigaDOS, the
  385. PARTITION length limit is 8 characters. The allowable DEVICE TYPES are as
  386. follows:
  387.  
  388.          H - Hard Drives
  389.          D - Floppy Drives (High Density and regular)
  390.          T - Tapes
  391.          F - AmigaDOS Files
  392.  
  393. If you perform more than one backup per day, Ami-Back places a sequence
  394. number on the end of the index file. So, for the second backup of the above
  395. device, the index file would be called DH2-C-T-04_15_92.IDX.1. Ami-Back
  396. allows you to perform up to 100 backups of the same device in one day.
  397.  
  398.                                     -15-
  399.  
  400. Index files contain information pertaining to the backups, and they are
  401. subsequently used in restoring files (more specifically, they are used for
  402. selective restores). The size of these files are determined by the number of
  403. files which are backed up. For example, a backup of 1600 files in number
  404. will create an index file of about 72 kilobytes in size.
  405.  
  406. Without index files, Ami-Back will only perform complete restores. (Ami-Back
  407. gives you the ability to rebuild index files should you have the need. See
  408. the Restore Type section for more information.)
  409.  
  410. BACKUP FILTER PATH (INCLUDE FILENAME)
  411.  
  412. This is the location of the file that holds the data for the Backup Filter.
  413. Ami-Back allows you to specify your own so that you may have a different
  414. filter with each configuration file. The default path name is
  415. S:BUAMI-BACK.FILTER.
  416.  
  417. The Backup Filter will process a list of up to 100 files, directories, or
  418. wild card entries that you specify. If the filter is active when Ami-Back is
  419. run, the listed files and directories or any files and directories that
  420. match any defined wildcard patterns will not be included in the backup. You
  421. may also use the same filter for each configuration file by leaving the name
  422. the same. You must enter the full path name of the filter. This means that
  423. the directory location and the name of the file must be included.
  424.  
  425. RESTORE FILTER PATH (INCLUDE FILENAME)
  426.  
  427. This filter operates in the same manner as the Backup Filter, and the
  428. required path specifications are the same. The default path name is
  429. S:RSAMI-BACK.FILTER.
  430.  
  431. DISPLAY ALERT
  432.  
  433. During operation, Ami-Back may need to notify you (through requesters) of
  434. changes in program status, or it may require you to provide additional
  435. backup media (most commonly in the form of floppy disks). By selecting the
  436. appropriate cycle gadget, you can direct Ami-Back to signal you by providing
  437. a visual FLASH ONLY, an audible BEEP ONLY, both a FLASH AND BEEP, or, if you
  438. prefer no audio or visual cue, you may select the NONE gadget, and Ami-Back
  439. will perform its functions transparently.
  440.  
  441.                                     -16-
  442.  
  443. PROGRAM OPERATIONS
  444.  
  445. Ami-Back gives you the ability to control the program read-write operations.
  446. Selecting ASYNCHRONOUS operations means that the program will read from the
  447. destination device while writing to the source device at the same time
  448. during the backup. Some older hard drive controllers are not suited for
  449. asynchronous operation and may cause your machine to lock up with high
  450. levels of DMA activity. By selecting SYNCHRONOUS operations this problem
  451. can be avioded. Note that by switching to synchronous operations you may
  452. notice a slight increase in the time required for backup and restore
  453. operations on most devices.
  454.  
  455. INDEX FILE LOCATION
  456.  
  457. You have the option of storing the Index File (necessary for backups and
  458. restores) in a location you specify or automatically with the backup set of
  459. floppy disks. (Should your Index File become lost or otherwise unavailable
  460. to you, Ami-Back gives you the ability to rebuild the index file. This will
  461. be discussed later.)
  462.  
  463. SHOW CONFIGURATION FIRST
  464.  
  465. Selecting this check box will cause Ami-Back to display the backup or
  466. restore configuration before a backup or restore is performed. This gives
  467. you a final opportunity to check the configuration before proceeding.
  468.  
  469. Once you have established the program path configurations to fit your system
  470. needs, you may select the SAVE gadget to permanently retain these settings.
  471. If, however, you decide to exit the Program Configuration option without
  472. making any changes, press the CANCEL gadget, and your last saved path
  473. configurations will be used. You may easily respecify any or all path
  474. configurations at any time by reselecting the Program Configuration
  475. subheading from the Ami-Back main screen menu bar.
  476.  
  477.                                     -17-
  478.  
  479. BACKUP CONFIGURATION
  480.  
  481. One of Ami-Back's most powerful features is its ability to give you complete
  482. control of all aspects of the backup procedure. In giving Ami-Back this
  483. capability, its programmers did not sacrifice any amount of the program's
  484. simplicity - ease of use was one of the main design considerations from the
  485. beginning of Ami-Back's developement.
  486.  
  487. To customize the backup configuration, activate the BACKUP CONFIGURATION
  488. subheading under PREFERENCES in the main screen menu. This will display the
  489. Ami-Back backups configuration window. Here you may specify the parameters
  490. of the backup you wish to perform.
  491.  
  492. SOURCE
  493.  
  494. First you must decide what device you wish to back up. When you open the
  495. Backup Configuration window for the first time (when there is no backup
  496. configuration file), the first AmigaDOS device in your device list will be
  497. selected and the backup/restore types will be set to Image. If there are no
  498. devices present, the gadget will display NO DEVICE.
  499.  
  500.                                     -19-
  501.  
  502. Ami-Back gives you the option of specifying any mounted device (and the RAM:
  503. device) as your backup source. All mounted devices will be listed in a row
  504. of icons across the top of the Backup Configuration window. (If there are
  505. more than five devics, you will be able to scroll them into view by clicking
  506. on the NEXT or PREV arrow gadgets.)
  507.  
  508. You may enter devices into the Source string gadget either by typing them
  509. directly or by clicking on the appropriate icons. You may also specify
  510. single device directories as backup sources. For example, if you wish to
  511. backup the C directory of the DH0: device, click on the DH0: icon so that
  512. the DH0: device is displayed. Then click within the string gadget so that a
  513. text cursor appears, and type C so that the source device will be listed as
  514. DH0:C.
  515.  
  516. It is also possible to specify a source device by name. Suppose your hard
  517. drive is divided into three partitions: DH0:, DH1:, and DH2:. If the DH2:
  518. partition is named DATA_STUFF:, you would be able to select that device by
  519. typing DATA_STUFF: into the source string gadget, Ami-Back will also
  520. recognize assigned directories. For example, if BIN: is an assignment to the
  521. directory DH1:PROGS partition, typing BIN: into the source string gadget is
  522. acceptable.
  523.  
  524. If you type your selections into the string gadget, be sure to press the
  525. RETURN key when you are done, otherwise Ami-Back will ignore the entry. The
  526. CLR gadget to the right of the Source string gadget will erase all
  527. selections from the string gadget.
  528.  
  529. If the source you specify is not a directory or mounted device, or if the
  530. source is not an AmigaDOS compatible device and the backup type is not Image
  531. or Recovery, Ami-Back will notify you by flashing the screen and/or beeping
  532. and displaying a requester that states "Not a valid source device." Click
  533. the CONTINUE gadget and respecify a valid device or change the backup type.
  534.  
  535. Once you have made a valid source device selection, it will remain in the
  536. device list during the current session in Ami-Back. Saving the configuration
  537. will save your selection as the default backup device. If the configuration
  538. is not saved, the source device selection will be lost and not listed the
  539. next time Ami-Back is run. (It is possible to save more than one backup
  540. configuration. This will be discussed later.)
  541.  
  542.                                     -20-
  543.  
  544. MULTIPLE DEVICE BACKUPS
  545.  
  546. Ami-Back allows you to backup multiple devices at one time. To backup
  547. multiple devices, you just enter the valid device (directory) names, making
  548. sure to seperate each device name with a space. For example, if you wanted
  549. to backup your WB_2.X: and WORK: partitions, you would click both the
  550. appropriate source icons or enter the following in the string gadget for
  551. your backup source:
  552.  
  553.    WB_2.X: WORK:
  554.  
  555. DESTINATION DEVICE
  556.  
  557. Now that you have determined what you will be backing up, you need to decide
  558. where to store that information. Ami-Back allows you to use any AmigaDOS
  559. compatible disk device as the destination for your backup. You may use
  560. floppy drives, high density floppy drives, hard drive partitions, removable
  561. drives, or SCSI tape drives as your storage media. You may also backup to a
  562. single AmigaDOS file. You may cycle through all the destination devices
  563. available to the program by clicking on the cycling Destination gadget.
  564.  
  565. FLOPPY DRIVE(S)
  566.  
  567. If you select Floppy Drive(s) as the destination, the available floppy
  568. drives will be displayed as button gadgets to the right of the Destination
  569. gadget. You may then select any or all of those gadgets depending upon which
  570. floppy drive(s) you wish to use during the backup. It is unnecessary to
  571. format floppy disks before using them for backups. Also, it does not matter
  572. if the disks are not empty. Any data that already exists on the floppies
  573. will be overwritten by the backup process.
  574.  
  575. Currently the AmigaDOS trackdisk.device supports a maximum of four floppy
  576. drives (DF0: to DF3: for regular floppy drives). If there is a high density
  577. floppy attached to your system, more than four floppy drives may be shown to
  578. be available (DF4: to DF7: for high density floppy drives - this is
  579. applicable only to Applied Engineering high density drives under Workbench
  580. 1.3 only).
  581.  
  582.                                     -21-
  583.  
  584. You may select up to four floppy drives as the backup destination device.
  585. However, you may not simultaneously select regular density and high density
  586. floppies as the destination device. Remember that if you select Floppy
  587. Drive(s) as your destination, you must specify at least one floppy drive as
  588. the destination for your backup. Remember that once you start your backup
  589. with either a regular or high-density floppy drive you must complete the
  590. backup with that type of drive.
  591.  
  592. Commodore has established a standard for high-density floppies. Ami-Back was
  593. written to support this standard. The Applied Engineering HD floppy
  594. trackdisk.device patch currently does not work with Kickstart 2.0. If and
  595. when the patch is updated to work with Kickstart 2.0, Ami-Back will support
  596. the Applied Engineering HD floppy drive.
  597.  
  598. TAPE DRIVE
  599.  
  600. If you select Tape Drive as your destination device, a Configure Tape gadget
  601. will appear to the right of the Destination gadget. Cliking on the Configure
  602. Tape gadget will bring up the Tape Drive Configuration window. Here is where
  603. you will set the options for your particular tape drive setup.
  604.  
  605.                                     -22-
  606.  
  607. If you do not wish to manually set all the options, you may want to make use
  608. of the Read Defaults gadget. To do so, you must first set the proper Device
  609. and SCSI ID (as described below) for your tape drive. Then, clicking on the
  610. Read Defaults gadget will direct Ami-Back to determine your tape drive's
  611. default settings.
  612.  
  613. DRIVE TYPE - For most drives this option should be set to Sequential. For
  614. users with the 3M tape drive (model 3M MCD-40) or other direct access drive
  615. types, however, make sure you have this option set to Direct rather than
  616. Sequential. Direct accessing tape drives use a different command set than
  617. sequential tape drives, and Ami-Back takes accounts for this.
  618.   
  619. DIRECT ACCESS - To use these tapes you must first format the tapes using
  620. Ami-Back. To do so, select the FORMAT command under the Tape menu in the
  621. main screen.
  622.  
  623. SEQUENTIAL-ACCESS - These tape drives are directly accessed by Ami-Back, and
  624. most likely will not be able to be mounted by your controller software.
  625. Ami-Back will work with any QIC standard drive (and SCSI controller) that
  626. supports SCSI-I or SCSI-II commands. See appendix II for a list of tape
  627. drives with which Ami-Back has been tested.
  628.  
  629. DEVICE - This string gadget is for the name of the device which controls the
  630. drive (the internal SCSI controller device name on the A3000, for example,
  631. is scsi.device). It is case sensitive. On the right of the Device gadget are
  632. right and left arrows that allow you to cycle through the available devices.
  633. You will have to consult your controller manual for your controller device.
  634. Most controller manufacturers store the needed device in the SYS:DEVS
  635. directory.
  636.  
  637. I/O MODE - There are two options for this mode: Asynchronous and
  638. Synchronous. The default selection for this option is Asynchrnous, and this
  639. is the proper setting for most tape drives. Again, the 3M drives that some
  640. users of Ami-Back have are exceptions, and in this case the Synchrnous I/O
  641. Mode is a better selection. The difference between the Asynchrnous and
  642. Synchrnous modes is that the Asynchrnous mode sends commands that allow the
  643. tape drive to disconnect from the SCSI bus (if this is supported by the
  644. drive and controller), while the Synchrnous mode causes Ami-Back to wait for
  645. a return of the command prior ro continuation (no disconnection). Thus the
  646. Synchrnous mode is slower, but it may be required with some configurations.
  647.  
  648.                                     -23-
  649.  
  650. SCSI ID - In this string gadget you may specify the SCSI unit number
  651. corresponding to your selected tape drive. In most cases the number is
  652. between 0 and 7, but Ami-Back accepts a range of 0 to 999 (the hundred's
  653. place digit corresponds to the SCSI controller board, the ten's place
  654. corresponds to the LUN SCSI ID, and the one's digit corresponds to the
  655. device) allowing for various configurations. The arrows on either side of
  656. the gadget allow you to increase or decrease the unit number by one.
  657.  
  658. BLOCK TYPE/BLOCK SIZE - Most SCSI drives use a Fixed block lngth of 512k, so
  659. that is the default setting for this option. The 3M drive, however, uses a
  660. Variable block length of 8192k, so the Block Size for this drive must be set
  661. to 8192 bytes. Most drives are of the fixed block type and require a block
  662. size of 512k, but some drives support higher block sizes for higher transfer
  663. efficencies.
  664.  
  665. AUTO TAPE SIZE/TAPE SIZE - The default condition for this condition is Yes,
  666. and under almost all conditions you will not have to change this. However,
  667. there are some combinations of controllers and drives that do not work well
  668. together. This problem becomes evident when Ami-Back is attempting to write
  669. data at the end of the tape; you will recieve an error. If you have problems
  670. backing up to multiple tapes, set the Auto Tape Size option to NO. Then you
  671. will be able to specify the maximum number of megabytes to be written to
  672. each tape in the Tape Size gadget. When the limit you have set is reached,
  673. you will be prompted for a new tape, and the backup process wil continue
  674. without error.
  675.  
  676. BUFFER (x2) - There is also a gadget to specify a Buffer size for tape drive
  677. operations (there is both a backup bufer and restore buffer) from 32k to 4
  678. MB. (Remember that the memory available must be contiguous.) When using tape
  679. drives that support reselection, the 32k buffer is considered to be the
  680. optimum choice for maximum speed (in most cases). For tape drives (or SCSI
  681. Controllers) that do not support reselection, we recommend that you use a 1
  682. MB buffer. The larger 2 MB and 4 MB options are provided, but these normally
  683. do not improve performance. The "x2" indicates that there are actually two
  684. buffers allocated of this size (the restore buffer is only a single buffer
  685. so the x2 size is not applicable).
  686.  
  687. MAXTRANSFER (BLOCKS) - This is the maximum number of blocks to be written to
  688. your tape drive. Normally the default of 128 will give you the best results.
  689. You may change this to optimize speed on your system. WARNING: Changing this
  690. value can cause erratic behavior during tape drive operation. (Set it to 128
  691. when using the 3M drive.)
  692.  
  693.                                     -24-
  694.  
  695. AUTO RETENSION - The Auto Retension gadget allows you to select whether or
  696. not you wish to retension a tape. It is recommended that you retension new
  697. tapes and tapes that haven't been used for long periods of time. You may
  698. select this option from under the Tape menu item from the Ami-Back main
  699. screen. Be sure to wait for the completion of the tape retension pass before
  700. proceeding with the backup.
  701.  
  702. TAPE APPEND - This option allows you to backup information onto tapes which
  703. contain information from previous backups. In this way you will be able to
  704. utilize the entire tape storage capacity rather than be forced to use a
  705. different tape each time you perform a backup. (Overwriting a tape that has
  706. multiple backups on it will destroy the backups on the tape.)
  707.  
  708. Backup and restore onfigurations for tape drives are the same. Changing one
  709. configuration will result in changing the other.
  710.  
  711. Once you have made your desired selections, select the USE gadget to return
  712. to the Backup Configuration screen.
  713.  
  714. AMIGADOS FILE
  715.  
  716. Ami-Back supports backups to single AmigaDOS files. When this option is
  717. selected as the destination, a string gadget for the File Name will appear
  718. to the right of the Destination gadget. Enter the complete path and filename
  719. for the file to which you wish to backup your data. The destination device
  720. must have enough free space to handle the entire backup. This means that the
  721. entire backup is stored as one large AmigaDOS file, and the resulting file
  722. can be manipulated as any other AmigaDOS file. This option is nice for users
  723. who want to backup one hard drive partition to another. It will allow the
  724. free space on the destination partition to still be available for use. (With
  725. a normal backup, the destination will be converted to a non-DOS partition.)
  726. The path and name of the destination file is user definable, however, the
  727. default is RAM:AMI-BACK.BAC. When backing up an AmigaDOS file from one hard
  728. drive partition to another partition, you will not expirence any significant
  729. speed loss.
  730.  
  731. BACKUP TYPE
  732.  
  733. Ami-Back allows you to perform five different types of hard disk backups
  734. depending on your particular requirements.
  735.  
  736.                                     -25-
  737.  
  738. COMPLETE
  739.  
  740. This backup mode will search and backup the entire source device you have
  741. selcted (based on your configuration criteria). A Complete backup is the
  742. type you would perform, for example, when backing up a hard disk drive for
  743. the first time.
  744.  
  745. SELECTIVE
  746.  
  747. This backup mode allows you to specify precisely which directories and/or
  748. files you wish Ami-Back to backup. It does so by building a "directory tree"
  749. of your source device, allowing you to make your selections from a displayed
  750. listing. This mode allows you to select from a single file to everything in
  751. your source device for backup.
  752.  
  753. 911-RECOVERY
  754.  
  755. This mode only works with fast file system disks, and the backup Source must
  756. be a single device only (hard drive partitions or floppy drives), and the
  757. device must be mounted. 911-Recovery backup works like a selective backup,
  758. except it doesn't go through the AmigaDOS file system -- it directly reads
  759. the data from the disk. This is useful if parts of the disk have been
  760. overwritten, and AmigaDOS won't recognize the disk or if parts of the disk
  761. are unreadable. You can also use this mode to recover deleted files.
  762.  
  763. IMAGE
  764.  
  765. Ami-Back gives you the option to perform Image backups of your data. This
  766. means that you can back up the exact image of the device. This option can
  767. only be used to backup entire devices; you cannot select the Image option to
  768. back up individual files, directories, etc. The advantage of this type of
  769. backup is in backing up non-AmigaDOS partitions (such as AMAX, UNIX, etc.)
  770. that cannot be backed up with standard Amiga backup commands or programs.
  771. Ami-Back is able to perform Image backups and restores as long as the
  772. selected partition is mounted.
  773.  
  774. You can perform Image backups to any device supported by Ami-Back (i.e.,
  775. file, floppy, etc.). When you perform an Image backup, you will only be able
  776. to restore the entire backup. It is not possible to perform incremental
  777. backup or restores for Image backups.
  778.  
  779.                                     -26-
  780.  
  781. While we recommend that you use the Image backup option for backing up
  782. non-AmigaDOS partitions, you may find other uses for it. For example, if you
  783. wish to copy an entire partition to another hard drive or partition, you
  784. will find that the Image backup option will do the job very well and
  785. extremely quickly. For this technique to work, you will have to rstore your
  786. data to another partition of the exact same size.
  787.  
  788. You cannot use Ami-Back as a disk copy program with Image backups or
  789. restores. Due to the information Ami-Back stores with the backup, this is
  790. impossible. Also, during an Image backup or restore to a partition, that
  791. partition is completely unavailable to the operating system.
  792.  
  793. BACKUP OPTIONS
  794.  
  795. LABEL BACKUP
  796.  
  797. This option will allow you to store a label for your backup set such as a
  798. Tape label, a disk set label, and so on. The information will be stored on
  799. the Index Filenote, and it will be displayed on the program if it exists.
  800. Writing a label to the first tape, disk, etc. allows you to correlate the
  801. different types.
  802.  
  803. WRITE NOTIFY
  804.  
  805. Selecting this gadget will instruct Ami-Back to notify you before
  806. overwriting information on the backup media.
  807.  
  808. BACKUP CATALOG
  809.  
  810. This option allows you to create a catalog of the files and directory
  811. structure of the backed-up data, which you can save at the end of the backup
  812. to an AmigaDOS file or to the PRT: device. If you save to a file, a
  813. requester will allow you to name the file, otherwise a default of
  814. ABCATALOG.TXT will be specified.
  815.  
  816. PASSWORD PROTECT
  817.  
  818. If the password protect option is set, you will be prompted for a password
  819. when the backup begins. This password is public key encrypted and stored in
  820. the backup header. The password is also used to encrypt the
  821.  
  822.                                     -27-
  823.  
  824. backup data using a simple fast encryption algorithm. On restore you must
  825. re-enter the password in order to restore your data. Keep in mind that if
  826. you should lose the password, there is no way to recover the backed up data.
  827.  
  828. USE BACKUP FILTER
  829.  
  830. This is your "on/off switch" for the Backup Filter. Selecting this option
  831. will activate the filter parameters for your backup, otherwise Ami-Back will
  832. ignore the filter parameters during backup. If you wish to activate the
  833. Backup Filter, be sure to configure the filter prior to use, as described
  834. below.
  835.  
  836. CONFIGURE FILTER
  837.  
  838. Selecting the Configure Filter gadget brings up the Backup Filter
  839. Configuration window. This is where you may set specifications for the
  840. File/Directory filter, protecion bits, and date stamp check. You can AND or
  841. OR any combination of these specifactions.
  842.  
  843.                                     -28-
  844.  
  845. FILE/DIRECTORY/COMMENT FILTER
  846.  
  847. This filter has many options. First you may enter an F or D or C as the
  848. first filter argument. This will force the filter to be applicable to the
  849. desired type (F=File, C=Comment, D=Directory). If none of these letters are
  850. specified, a default specification of FILE is used.
  851.  
  852. FORMAT EXAMPLE:  F - *.INFO
  853.                  ^ ^ ^
  854.                  | | |------ This starts the filter argument
  855.                  | |         (can use ANY amigados wildcard scheme)
  856.                  | |
  857.                  | |-------- This means exclusion type argument
  858.                  |           (possibilities are - or +)
  859.                  |
  860.                  |---------- This means FILE type argument
  861.                              (possibilities are F/D/C)
  862.                              (If not present will default to FILE
  863.                              type)
  864.  
  865. The next character must be either a "-" symbol or a "+" symbol. This will
  866. direct the filter argument to work with Inclusion or Exclusion mode. The "-"
  867. symbol works with Exclusion mode and the "+" symbol works with Inclusion
  868. mode. This means that when you have the file filter active in the Inclusion
  869. mode, only the "+" items are used, and when Exclusion is specified, only the
  870. "-" items are used. Both kinds of items are used if both filter modes are
  871. specified, however, the Inclusion is actually performed first. If you are
  872. using the Inclusion mode you must enter a D+* if you want sub-directories to
  873. be included. (D+* will include all directories, and other arguments may be
  874. used instead.)
  875.  
  876. There may be files and/or directories that you will consistently wish to
  877. exclude from or include in the backups, and these files and/or directories
  878. may have names with common elements, rather than being uniquely-named. The
  879. filter can hold a list of filenames/directories or partial
  880. filenames/directories combined with metacharacters (wildcards) that will
  881. exlude from or include in backup searches, and this list can be used every
  882. time Ami-Back is run.
  883.  
  884. For example, you may decide not to back up any file with the .info suffix.
  885. While it would be possible for you to specify Selective as the default
  886. backup type, and then manually MARK or EXCLUDE all those .info files, it
  887.  
  888.                                     -29-
  889.  
  890. is more convenient to make use of the Backup Filter for this task. Standard
  891. AmigaDOS wildcard schemes are used, and you may also use the "*" (asterik)
  892. characters to represent any amount of characters.
  893.  
  894. The more items you include in the filter, the longer the source device
  895. search will take before the actual backup. This is because each file and
  896. directory on the source device must be matched against all of the items
  897. listed in the filter. A few items, however, will make no appreciable
  898. difference in the execution time of the search.
  899.  
  900. ADDING PARAMETERS
  901.  
  902. Let's continue with the example of excluding all files with the .INFO
  903. suffix. First you will need to add an item to the filter list which
  904. represents all the files you want to exclude. Click the ADD gadget on the
  905. filter requester, and the string gadget allowing you to input text becomes
  906. active. You might type F-.INFO now, but that would only represent files with
  907. the name of the .INFO rather files with that as a suffix. You need to
  908. utilize AmigaDOS wildcards (see your AmigaDOS manual for more information).
  909. Type F-#?.INFO or F-*.INFO and then press the carriage return. The exclusion
  910. parameter F-*.INFO is now entered into the filter list. Now when the
  911. exclusion filter is used during a backup, all files with the .INFO suffix
  912. will be ignored.
  913.  
  914. You may add more parameters to the filter such as individual files
  915. (Preferences), all files that start with the letter B (B#?), or whatever
  916. else you like. Each time you add a parameter, the exclusion filter list will
  917. be updated in alphabetical order.
  918.  
  919. If you enter a parameter which includes any illegal characters and try to
  920. save it to the filter, you will be prompted by a requester that says
  921. "Illegal filter type. First character must be a + or -." Clicking on the
  922. CONTINUE gadget will remove the requester as well as the offending
  923. parameter.
  924.  
  925. DELETING PARAMETERS
  926.  
  927. The procedure to delete items from the filter list is simple. Just click on
  928. the item which you wish to delete (using the scroll bar to find the
  929. parameter if necessary). The DEL gadget will become active, and clicking on
  930. it will delete the specified item.
  931.  
  932.                                     -30-
  933.  
  934. MODIFYING PARAMETERS
  935.  
  936. To modify items in the filter, begin as if to delete an item; however, do
  937. not select the DEL gadget. Simply change the contents of the string gadget,
  938. and press the return key. The item will be modified and placed back into the
  939. filter (and the original item will be deleted).
  940.  
  941. PROTECTION BIT FILTER 
  942.  
  943. This will allow you to check the date range of files you wish to
  944. include/exclude from your backup. You may set the range of dates and times
  945. in DOS, INT (international), USA, or CANADIAN format, and then specify
  946. whether you wish to check for files within or outside this date range. The
  947. default FROM date is always the last backup date (datestamp of the current
  948. configuration), and the TO date is always the system date on startup of
  949. Ami-Back. If you desire, you may set other bracketing dates by typing in the
  950. string gadgets or using the arrow gadgets.
  951.  
  952. AND/OR - Ami-Back gives you the ability to select any of these filter
  953. parameters in logical AND or OR combinations. For the AND/OR operations to
  954. be available, at least two of the three filters must be active.
  955.  
  956. Once you have made your Backup Filter Configuration selections, select the
  957. USE gadget to return to the Backup Configuration window. If you decide that
  958. you do not wish to change the Backup Filter, select the CANCEL gadget and
  959. all settings will revert to the last-saved parameters.
  960.  
  961. LEAVING THE BACKUP CONFIGURATION MODE
  962.  
  963. After you have configured Ami-Back's backup options, you may exit this mode
  964. by one of three ways.
  965.  
  966. CANCEL - Selecting the CANCEL gadget allows you to exit the backup
  967. configuration mode with no change made to the existing enviornment. The
  968. previously used backup configuration will be restored.
  969.  
  970.                                     -31-
  971.  
  972. USE - Selecting the USE gadget will activate your configuration changes for
  973. the current execution of Ami-Back. However, no changes will be made to the
  974. configuration file, and your previously saved configuration will be restored
  975. for the next time you run Ami-Back.
  976.  
  977. SAVE - The SAVE gadget will save all the changes you made in the backup
  978. configuration mode to the current configuration file. This will not effect
  979. your other configuration changes.
  980.  
  981.                                     -32-
  982.  
  983. RESTORE CONFIGURATION
  984. ----------------------------------------------------------------------------
  985.  
  986. Just as in the Backup Configuration mode, Ami-Back gives you complete
  987. flexibility in setting your Restore Configuration options. To enter the
  988. Restore Configuration mode, activate the RESTORE CONFIGURATION subheading
  989. under the PREFERENCES menu in the main screen menu bar.
  990.  
  991. To customize the restore configuration as you wish, activate the RESTORE
  992. CONFIGURATION subheading under EDIT in the main screen menu. This will
  993. display the Ami-Back Restore Configuration window. From here you may specify
  994. all the parameters of the restore you wish to perform.
  995.  
  996. DESTINATION
  997.  
  998. First you must decide to what device you wish to restore your data. Ami-Back
  999. gives you the option of specifying any mounted device (and the RAM: device)
  1000. as your restore destination. All mounted devices will be listed in a row of
  1001. icons across the top of the Restore Configuration window. (if there are more
  1002. than five devices, you will be able to scroll them into view by clicking on
  1003. the NEXT or PREV arrow gadgets.)
  1004.  
  1005. You may enter devices into the Destination string gadget either by typing
  1006. them directly or by clicking on the appropriate icons. You may also specify
  1007. single device directories as destinations. For example, if you wish to
  1008. restore the C directory of the DH0: device, click on the DH0: icon so that
  1009. the DH0: device is displayed. Then click within the string gadget so that a
  1010. text cursor appears, and type C so that the source device will be listed as
  1011. DH0:C.
  1012.  
  1013. It is also possible to specify a destination device by name. Suppose your
  1014. hard drive is divided into three partitions: DH0:, DH1:, and DH2:. If the
  1015. DH2: partition is named DATA_STUFF:, you would be able to select that device
  1016. by typing DATA_STUFF: into the destination string gadget. Ami-Back will also
  1017. recognize assigned directories. For example, if BIN: is an assignment to the
  1018. directory DH1:PROGS partition, typing BIN: into the source string gadget is
  1019. acceptable.
  1020.  
  1021.                                     -33-
  1022.  
  1023. If you type your selections into the string gadget, be sure to press the
  1024. RETURN key when you are done, otherwise Ami-Back will ignore the entry. The
  1025. CLR gadget to the right of the destination string gadget will erase all
  1026. selections from the string gadget.
  1027.  
  1028. If the destination you specify is not a directory or mounted device, or if
  1029. the source is not an AmigaDOS compatible device and the restore type is not
  1030. Image, Ami-Back will notify you by flashing the screen and/or beeping and
  1031. displaying a requester that states "Not a valid destination device." Click
  1032. the CONTINUE gadget and respecify a valid device or change the restore type.
  1033.  
  1034. Once you have made a valid destination device selection, it will remain in
  1035. the device list during the current session in Ami-Back. Saving the
  1036. configuration will save your selection as the default restore device. If the
  1037. configuration is not saved, the destination device selection will be lost
  1038. and not listed the next time Ami-Back is run. (It is possible to save more
  1039. than one restore configuration. This will be discussed later.)
  1040.  
  1041. When you select your restore device destination, be sure to use the same
  1042. device path that you specified in your Backup Configuration file. For
  1043. example, if your backup source is your SYS: partition, then you should
  1044. specify the SYS: partition for your restore destination device. Otherwise,
  1045. if you were to select SYS:T as your destination device and then you were to
  1046. restore the file C:DIR from the backup disk, the path for the restore would
  1047. end up being SYS:T/C/DIR.
  1048.  
  1049. MULTIPLE DEVICE RESTORES
  1050.  
  1051. Ami-Back allows you to restore multiple devices at one time. To restore
  1052. multiple devices, you just enter the valid device (directory) names, making
  1053. sure to seperate each device name with a space. For example, if you wanted
  1054. to backup your WB_2.X: and WORK: partitions, you would click both the
  1055. appropriate source icons or enter the following in the string gadget for
  1056. your backup source:
  1057.  
  1058.     WB_2.X: WORK:
  1059.  
  1060. If you backed up WB_2.X: and WORK:, and you assigned DH0: to WB_2.X: and
  1061. DH1: to WORK:, you may also use those assignment names when restoring, so
  1062. these names are used by the program. This will change your device list on
  1063. the selective restore to be DH0: and DH1:
  1064.  
  1065.                                     -34-
  1066.  
  1067. SOURCE
  1068.  
  1069. Now you may specify the source from which your backed-up data will be read
  1070. for the restore process. Ami-Back allows you to use any AmigaDOS compatible
  1071. disk device excluding the RAM: device as the source of your restore. You may
  1072. use floppy drives, high density floppy drives, hard drive partitions,
  1073. removable drives, or SCSI tape drives as your source media. You may cycle
  1074. through all the source devices available to the program by clicking on the
  1075. Source gadget.
  1076.  
  1077. FLOPPY DRIVE(s)
  1078.  
  1079. If you select Floppy Drive(s) as the source, the available floppy drives
  1080. will be displayed as button gadgets to the right of the Source gadget. You
  1081. may then select any or all of those gadgets depending upon which floppy
  1082. drive(s) you wish to use during the restore process. You may select up to
  1083. four floppy drives as the restore source device. (You may not simultaneously
  1084. select both regular density and high density floppies as the source device
  1085. if you are using Applied Engineering high density floppies under Workbench
  1086. 1.3.) Remember that if you select Floppy Drive(s) as your source, you must
  1087. specify at least one floppy drive as the source for your restore.
  1088.  
  1089. TAPE DRIVE
  1090.  
  1091. If you select Tape Drive as your restore device, a Configure Tape gadget
  1092. will appear to the right of the Source gadget. Clicking on the CONFIGURE
  1093. TAPE gadget will bring up the Tape Drive Configuration window. This is the
  1094. same configuration window that appeared when you configured your tape drive
  1095. for bakups, and the settings currently stored are those which you selected
  1096. during the backup configuration. See Tape Drive in the Backup Configuration
  1097. section for more information.
  1098.  
  1099. AMIGADOS FILE
  1100.  
  1101. Ami-Back supports restores from single AmigaDOS files. When this option is
  1102. selected as the source, a string gadget for the File Name will appear to the
  1103. right of the Destination gadget. Enter the complete path and filename for
  1104. the file from which you wish to restore your data. The destination device
  1105. must have enough free space to handle the entire restore.
  1106.  
  1107.                                     -35-
  1108.  
  1109. RESTORE TYPE
  1110.  
  1111. Ami-Back allows you to perform five different types of restores depending on
  1112. your particular requirements.
  1113.  
  1114. COMPLETE
  1115.  
  1116. This restore mode will restore all your backed-up data. A Complete restore
  1117. is the type you would perform, for example, after reformatting a hard disk
  1118. partition.
  1119.  
  1120. SELECTIVE
  1121.  
  1122. Clicking on the SELECIVE gadget allows you to restore only files or
  1123. directories that you directly specify. This option is especially useful when
  1124. you wish to restore a single file or directory. To make use of this option,
  1125. you must have an index file available in the directory which you named while
  1126. setting the Program Configuration. Without an index file, Ami-Back is only
  1127. able to perform complete restores of your data. It is possible to
  1128. reconstruct an index by using the Build Index restore option (see below).
  1129.  
  1130. It is possible to perform selective restores from multi-device backups. If
  1131. you backup to a device with a multi-device backup and then want to perform a
  1132. selective restore, you will have to enter the same number of devices to
  1133. restore to as you backed up from in the same order as they were backed up.
  1134. However, you may "fool" the program if you want to restore only several
  1135. files or directories to a single device instead of to multiple devices. To
  1136. do so, enter the same device name more than once. For example, if you backed
  1137. up partitions WB_2.X: and WORK:, and you wanted to restore a couple of files
  1138. from each partition to RAM:, you would enter in the restore destination
  1139. gadget RAM: RAM:. This way you will have two destination device names as the
  1140. program requires, and you will be restoring to one device.
  1141.  
  1142. COMPARE
  1143.  
  1144. Though listed under the Restore Type category, this option does not actually
  1145. perform a restore of any data. Rather, Compare allows you to take a backup
  1146. (usually the last one performed) and compare it against your current
  1147. filesystem in order to obtain a list of the differences. This operation
  1148.  
  1149.                                     -36-
  1150.  
  1151. is useful after a hard drive crash or any other situation which might result
  1152. in an unexpected data loss. Although Ami-Back does not perform any
  1153. diagnostics, you can utilize the "911-Recovery" backup mode to recover lost
  1154. data. See the section on backup options for more information.
  1155.  
  1156. Using the Compare option will assist you in determining if any files are
  1157. missing or have been corrupted. The Compare function is performed only with
  1158. the information on the actual backup media.
  1159.  
  1160. IMAGE
  1161.  
  1162. Ami-Back gives you the ability to restore individual partitions from
  1163. multi-device Image backups. Take the above example in which you backed up
  1164. the WB_2.X: and WORK: partitions. If you wished to restore only the WORK:
  1165. partition, you could enter NIL: WORK: as your restore destination. This
  1166. would send the WB_2.X: partition data off to Never-Never Land, so to speak,
  1167. while properly restoring the WORK: partition data. (This feature will only
  1168. work with the Image restore option!)
  1169.  
  1170. BUILD INDEX
  1171.  
  1172. When Ami-Back backs up your data it creates an index that can be used later
  1173. to selectively restore the data. It is possible that the index file may
  1174. become corrupted or otherwise lost. It is always possible to perform a
  1175. complete restore even if you no longer have the index file for the backed up
  1176. data. However, Ami-Back also gives you the ability to rebuild a new index
  1177. file for your backed-up data. To do this, you must select BUILD INDEX under
  1178. Restore Type when setting your restore configuration. You then perform the
  1179. same steps as you would do when performing a complete restore. This will not
  1180. restore any files. At the end of the rebuild you will be provided a
  1181. requester allowing you to name the new index file. Make sure the name ends
  1182. with a .IDX suffix.
  1183.  
  1184. FILE DATE
  1185.  
  1186. Selecting the Original gadget maintains your files' original datestamps.
  1187. Selecting the System Date gadget will result in all files adopting the
  1188. current system datestamp during the restore process.
  1189.  
  1190.                                     -37-
  1191.  
  1192. DIR STRUCTURE
  1193.  
  1194. This option allows you to restore files with or without rebuilding the
  1195. backed-up directory structure. Selecting the Maintain gadget instructs the
  1196. program to rebuild the directory as it was stored, while selecting Single
  1197. Directory is appropriate when you wish to ignore the directory structure and
  1198. restore all files to a single directory.
  1199.  
  1200. FILE DETECTION
  1201.  
  1202. In some situations, you will be restoring files to a device where those
  1203. files already exist. However, there will also be occassions when you will be
  1204. restoring files because the original files were deleted or corrupted. Since
  1205. different conditions may exist when you restore files, Ami-Back gives you
  1206. three options for dealing with these situations.
  1207.  
  1208. WRITE-OVER
  1209.  
  1210. Selecting this option will result in the files on the destination device
  1211. being over-written during the restoration of files.
  1212.  
  1213. WRITE-OVER (DATE)
  1214.  
  1215. This option operates similiarly to Write Over, however, only files on the
  1216. destination device that are older than the corresponding files on the backup
  1217. will be overwritten. Duplicated files will not be restored but skipped
  1218. instead.
  1219.  
  1220. RENAME
  1221.  
  1222. If this option is selected, whenever a duplicate file is detected, Ami-Back
  1223. will bring up a requester that gives you the opportunity to rename the file
  1224. during the restore process. The renamed file will be restored to the same
  1225. directory as the original file. You are also allowed to skip over the file
  1226. (as outlined above).
  1227.  
  1228.                                     -38-
  1229.  
  1230. FILE PROTECTION BITS
  1231.  
  1232. This option allows you to ontrol the setting of the file protection bits
  1233. during your restoration. Selecting the ORIGINAL gadget results in the files
  1234. being restored with their protection bits unchanged. (You will usually
  1235. maintain this setting.) Selecting the USER SELECT gadget will allow you to
  1236. specify the status of each partition bit setting for all your files as they
  1237. are restored. You will be able to make your selections using the PRO BITS
  1238. gadgets to the right. (Refer to your AmigaDOS manual for more information
  1239. concerning the different protection bit and their uses.)
  1240.  
  1241. USE RESTORE FILTER
  1242.  
  1243. This is your "on/off" for the Rstore Filter. Selecting this option will
  1244. activate the filter parameters for your restore, otherwise Ami-Back will
  1245. ignore the filter parameters during the restore. The Restore Filter only
  1246. operates during the Complete or Compare restore modes. If you wish to
  1247. activate the Restore Filter, be sure to configure the filter prior to use.
  1248. The configuration and operation of the Restore Filter is the same as the
  1249. Backup Filter, so refer back to Configure Filter in the Backup Configuration
  1250. section for more information.
  1251.  
  1252.                                     -39-
  1253.  
  1254. LEAVING THE RESTORE CCONFIGURATION MODE
  1255.  
  1256. The SAVE, USE, and CANCEL gadgets are used here in the same manner as the
  1257. correspnding Backup Configuration screen gadgets.
  1258.  
  1259.                                     -40-
  1260.  
  1261. MEDIA REQUIREMENTS
  1262. ----------------------------------------------------------------------------
  1263.  
  1264. Floppy disks do not have to be formatted prior to backing up to them with
  1265. Ami-Back, unless you are backing up an AmigaDOS file.
  1266.  
  1267. Since most tapes come pre-formatted, they do not require formatting. All
  1268. other media must be formatted before using. Tapes, removable media, and
  1269. fixed hard drive partitions must be formatted to the requirements of
  1270. AmigaDOS before Ami-Back will recognize them. Connect tape drives to your
  1271. SCSI controller per your controller documentation.
  1272.  
  1273. If you want to maintain your backup destination device as an Ami-back
  1274. partition, be sure you have specified MOUNT=0 in your mountlist entry file
  1275. for devices you wish to mount. Specifying anything else will result in a
  1276. "Not a DOS disk" error (on system startup).
  1277.  
  1278.                                     -41-
  1279.  
  1280. SCHEDULER CCONFIGURATION
  1281. ----------------------------------------------------------------------------
  1282.  
  1283. You have the option of using Ami-Back manually whenever you wish, or
  1284. allowing its companion program, Ami-Sched to control its execution
  1285. automatically. Ami-Sched is a scheduling utility (see the section on
  1286. Ami-Sched) which is used to run Ami-Back at pre-determined intervals.
  1287.  
  1288. Before you run Ami-Sched you should configure the program to fit your
  1289. particular needs. (If you do not reconfigure Ami-Sched before running it,
  1290. Ami-Sched will activate Ami-Back every day at midnight, which is its default
  1291. configuration mode.)
  1292.  
  1293. To enter the scheduler configuration mode, select the Scheduler gadget from
  1294. the main screen. Once in the Scheduler Configuration mode, you will see five
  1295. calendar-like requesters: 1) "Months Per Year," 2) "Days Per Month,"
  1296. 3) "Days Per Week," 4) "Hours Per Day," and 5) "Mins Per Hour."
  1297. Additionally, you will see gadgets for selecting the Scheduler
  1298. Configuration, setting the Configuration Status and the Event Type, and
  1299. selecting the Backup Configuration file to use.
  1300.  
  1301.                                     -43-
  1302.  
  1303. When you enter the Schedule Configuration mode for the first time, you will
  1304. notice that the number gadget 0 in the "Hours Per Day" and "Mins Per Hour"
  1305. requesters are already selected. This is Ami-Sched's default configuration
  1306. which runs Ami-Back every midnight. If, for example, you wish to change the
  1307. backup time to every day at noon instead of midnight, you would click the 0
  1308. gadget under the "Hours Per Day" heading to deactivate it and then click the
  1309. 12 gadget in the same heading to activate it.
  1310.  
  1311. If a specific time or date for backup is not selected, Ami-Sched will behave
  1312. as if all times and dates are selected. By selecting one or more gadget in
  1313. any of the date/time requesters, you will limit the backups to those
  1314. specific times and/or dates.
  1315.  
  1316. The "Days Per Month" and "Days Per Week" gadgets are mutually dependent for
  1317. their operational values. If nothing is selected under either heading,
  1318. backups will occur every day of the month. If, however, any "Days Per Month"
  1319. (1,2,3, etc.) are selected, backups will occur only on those dates. If any
  1320. "Days Per Week" (Sun, Mon, Tue, etc.) are selected, backups will occur only
  1321. on these days. Finally, if certain "Days Per Month" are selected in addition
  1322. to certain "Days Per Week," backups will occur on both these dates of the
  1323. month and these days of the week.
  1324.  
  1325. (If you are familiar with the UNIX operating system, you will see that
  1326. Schedule Configuration setup is similar to a UNIX cron file entry.) For
  1327. example, if you select a particular month - say Jul - in the "Months Per
  1328. Year" requester, the program will only perform backups during July. If, on
  1329. the other hand, no month is selected, backups will be performed every month.
  1330. You can configure Ami-Sched so that backups are performed as frequently as
  1331. once an hour every day or as seldomly as once a year.
  1332.  
  1333. Users may select only one time gadget in the "Mins Per Hour" requester and
  1334. one time gadget in this requester must always be selected. The following
  1335. examples show you how Schedule Configuration works.
  1336.  
  1337. EXAMPLE 1
  1338.  
  1339. In the "Months Per Year" requester activate FEB, JUL, and NOV. Click 1, 15,
  1340. and 31 in the "Days Per Month" requester, and activate FRI in the "Days Per
  1341. Week" requester. In the "Hours Per Day" requester activate 23, and activate
  1342. 30 in the "Mins Per Hour" requester. With this configuration, backups will
  1343. be performed at 11:30 P.M. on February 1st and 15th, on July 1st, 15th and
  1344. 31st, and on November 1st and 15th, and also on every Friday of these
  1345. months.
  1346.  
  1347.                                     -44-
  1348.  
  1349. EXAMPLE 2
  1350.  
  1351. Activate WED and SAT for "Days Per Week," 9 and 18 for "Hours Per Day," and
  1352. 45 for "Mins Per Hour." In this case, backups will be performed at 9:45 A.M.
  1353. and 6:45 P.M. on every Wednesday and Saturday of every month in the year.
  1354.  
  1355. MULTIPLE SCHEDULER CONFIGURATIONS
  1356.  
  1357. The Scheduler Configuration gadget allows you to select any of 10 different
  1358. backup configuration files. This means, for example, that at midnight you
  1359. can call Ami-Back with S:AMI-BACK1.CONFIG and at 12:30 am you can call
  1360. Ami-Back with S:AMI-BACK2.CONFIG. The backups will be performed with the
  1361. backup information saved in these configuration files.
  1362.  
  1363. To set up a configuration file, go to the scheduler configuration and
  1364. specify the time for backup as described above. Select the configuration you
  1365. wish to work on by clicking on the cycle gadget that has CONFIGURATION 1
  1366. through CONFIGURATION 10.
  1367.  
  1368. You may render a particular configuration or inactive by clicking on the
  1369. Configuration Status gadget. If a configuration file is inactive, the
  1370. sheduler will ignore it.
  1371.  
  1372. EVENT TYPE
  1373.  
  1374. If this option in the scheduler is specified as MESSAGE, when the scheduled
  1375. backup time arrives, instead of performing a backup, a requester will appear
  1376. informing the user that it is time for a backup and asking whether a
  1377. backup should be performed. Otherwise the backup will be performed without
  1378. notification.
  1379.  
  1380. In the string gadget that comes up for the first time (which defaults to
  1381. S:AMI-BACK.CONFIG), you must enter the full path name of the configuration
  1382. file you wish to use. You are allowed to name your configuration files,
  1383. so you can store as many configurations as you wish. Remember that Ami-Sched
  1384. can only use 10 configurations at any time.
  1385.  
  1386. Ami-Back is protected from running multiple copies at the same time. It
  1387. would be very dangerous to allow multiple backups to take place at the same
  1388. time.
  1389.  
  1390.                                     -45-
  1391.  
  1392. DEFAULT SETTINGS
  1393.  
  1394. By selecting the DEFAULT SETTINGS gadget, you will automatically reconfigure
  1395. Ami-Sched to the "one backup per day" mode that was its original
  1396. configuration.
  1397.  
  1398. LEAVING THE SCHEDULE CONFIGURATION MODE
  1399.  
  1400. Once you have set the Schedule Configuration as you like, click on the SAVE
  1401. gadget near the bottom left corner to save your selections for use with
  1402. Ami-Sched. If you decide that you do not want to retain any of the changes
  1403. you made, clicking on the CANCEL gadget will restore the Schedule
  1404. Configuration to its previous settings.
  1405.  
  1406. MULTIPLE CONFIGURATION FILES
  1407.  
  1408. Ami-Back gives you the ability to save multiple configuration files. From
  1409. the Project menu item you may select between NEW CONFIGURATION, LOAD
  1410. CONFIGURATION, or SAVE CONFIGURATION.
  1411.  
  1412.                                     -46-
  1413.  
  1414. NEW CONFIGURATION allows you to create a new configuration file. You will
  1415. first be asked what you wish to name the file. You may CANCEL this option or
  1416. CONTINUE to create a new configuration file. By changing the name and
  1417. seleting the DEFAULT gadget (or pressing the RETURN key), you will be given
  1418. a configuration with the initial program defaults. By changing the name and
  1419. pressing the RETURN key or selecting the CONTINUE gadget, you will get a new
  1420. configuration file with the parameters of the previous configuration file.
  1421.  
  1422. LOAD CONFIGURATION allows you to load a previously saved configuration file.
  1423.  
  1424. SAVE CONFIGURATION allows you to save the current configuration file under a
  1425. different name or save the parameters you selected but haven't yet saved.
  1426.  
  1427. Remember that when you load or save a configuration file with the menu
  1428. options, that configuration becomes the program's current configuration.
  1429. Whenever you change the configuration and select the SAVE gadget, you will
  1430. be saving to the current configuration. This also occurs when you select the
  1431. NEW CONFIGURATION option. You can check for the active configuration name in
  1432. the ABOUT information window.
  1433.  
  1434.                                     -47-
  1435.  
  1436. RUNNING AMI-BACK
  1437. ----------------------------------------------------------------------------
  1438.  
  1439. There are four ways for you to run Ami-Back. You can call the program
  1440. directly by selecting its icon from Workbench, by using the Shell, or by
  1441. starting Ami-Sched (see the section on running Ami-Sched), or as an AREXX
  1442. server.
  1443.  
  1444. You may start the program from Workbench with a different configuration file
  1445. by specifying the CONFIG tooltype this way:
  1446.  
  1447.      CONFIG=SYS:S/AMI-BACK.CONFIG2
  1448.  
  1449. This will run Ami-Back with the configuration file you have selected. You
  1450. may also use the tooltype NOWINDOWS. By specifying this tooltype Ami-Back
  1451. will run in the background using the current configuration, and no windows
  1452. will be opened.
  1453.  
  1454. When you call Ami-Back directly, the main screen will appear. Under the
  1455. program title and the copyright notice information are four gadgets: BACKUP,
  1456. RESTORE, SCHEDULER, and QUIT. Clicking on any of these gadgets will direct
  1457. the program to perform the appropriate action.
  1458.  
  1459. Ami-Back gives you several options when you run it from the Shell. See the
  1460. section Performing Backups from the Shell for more information on these
  1461. options.
  1462.  
  1463.                                     -49-
  1464.  
  1465. PERFORMING BACKUPS
  1466. ----------------------------------------------------------------------------
  1467.  
  1468. Once you have configured your desired backup options, you can start
  1469. performing backups. It is not necessary to have your restore options
  1470. configured when backing up, but you will need to configure restore options
  1471. before you can restore data. Clicking the QUIT gadget at the main screen
  1472. will immediately end the backup session. Execute Ami-Back from Workbench or
  1473. from the Shell. If you selected the SHOW CONFIGURATION FIRST option in the
  1474. Program Configuration window, Ami-Back will immediately display the Backup
  1475. Configuration allowing you to make any changes necessary. Click the USE or
  1476. SAVE gadget to continue with the backup.
  1477.  
  1478. COMPLETE
  1479.  
  1480. When performing a Complete backup, Ami-Back first searches the source device
  1481. based on your backup configuration file.
  1482.  
  1483. A Small window appears which states "Searching Source Devices." This window
  1484. gives information on the device(s), number of sub-directories, number of
  1485. files, byte size of the backup and the available free system memory. The
  1486. window also contains an ABORT gadget. If you wish to dis-
  1487.  
  1488.                                     -51-
  1489.  
  1490. continue the backup at this point, you may click the ABORT gadget and
  1491. Ami-Back will return to the main screen.
  1492.  
  1493. If you selected the SHOW CONFIGURATION FIRST option when setting the program
  1494. Configuration, as soon as you instruct Ami-Back to perform a backup, the
  1495. backup configuration screen will be displayed giving you a final opportunity
  1496. to check the configuration before proceeding. To continue, you must select
  1497. either the SAVE or USE gadget. Selecting the CANCEL gadget will abort the
  1498. backup.
  1499.  
  1500. After Ami-Back has completed its search, the Backup Information Screen will
  1501. appear. This screen provides you with information concerning the backup.
  1502. Under the window title bar you will see the selected Source and Destination
  1503. and the Backup Type listed. Estimated and Actual figures are given for the
  1504. number of Files, Bytes, and Disks used in the backup.
  1505.  
  1506. There are several other displays that give information on the program status
  1507. as the backup is being performed.
  1508.  
  1509. BACKING UP - This displays the current file, including path, being written
  1510. to the backup destination. If the full path is too long to be displayed,
  1511. Ami-Back will split the path name and place "./" in front in order to let
  1512. you know that the entire path/filename is too long to be given on screen.
  1513.  
  1514. CURRENT DEVICE - This displays the destination device being written to.
  1515.  
  1516. BACKUP COMPLETE - This is a sliding scale that displays the percentage of
  1517. the backup which has been completed both graphically and numerically.
  1518.  
  1519. DESTINATIN FULL - This is the sliding scale that shows the percentage of the
  1520. destination media that has been filled. This display operates only during
  1521. Complete or Selective backups to floppy disks. During backups with tape
  1522. drives you will not be given this information. (There is no accurate way of
  1523. determining the actual length of the tape in use without, of course, testing
  1524. it first -- which would take a while!)
  1525.  
  1526. BU TIME/TIME LEFT/USER TIME - These time displays show the amount of time
  1527. consumed by the actual backup, the amount of time that Ami-Back estimates to
  1528. remain, and the amount of time taken by the user (during changes of media,
  1529. for example). The Time Left display does not work for selective restores.
  1530. Time Left is an indicator only, and it does not provide exact times for the
  1531. backup process. This is because Ami-Back calculates remaining time based on
  1532. the average transfer rate of the backup. This is dependent on several
  1533. factors, and is especially variable during operations with floppy disks.
  1534.  
  1535. BACKUP ERROR LIST - This display will let you know how many errors have
  1536. occured during the backup procedure (whether on the source device or on the
  1537. destination device). The Backup Error List lists on what files the errors
  1538. occured and the types of errors encountered, and then it will allow you to
  1539. scroll through theses errors. If any erros occur, you will be given the
  1540. opportunity to save the error list at the end of the backup.
  1541.  
  1542. At the bottom of the Backup Information screen are three gadgets: BEGIN
  1543. BACKUP, ABORT (ghosted), and QUIT BACKUP. Selecting the QUIT BACKUP gadget
  1544. at this point will return you to the main program screen. Selecting the
  1545. BEGIN BACKUP gadget will begin the actual backup.
  1546.  
  1547. BACKUP LABEL
  1548.  
  1549. If you selected BACKUP LABEL as one of your backup options, a requester
  1550. which states "Enter backup set label" will appear. This requester is
  1551. displayed on a selective restore after the index file is loaded. Type a
  1552. label for your backup set into the string gadget, press return, then click
  1553. on the CONTINUE gadget.
  1554.  
  1555.                                     -53-
  1556.  
  1557. PASSWORD PROTECT
  1558.  
  1559. If you selected PASSWORD PROTECT as one of your backup options, a requester
  1560. which states "Enter password for this backup:" will appear. Type a password
  1561. into the string gadget, press RETURN, then click on the CONTINUE gadget.
  1562. When you perform a restore you will be required to supply this password. If
  1563. you are unable to do so, you will not be able to restore your data.
  1564.  
  1565. A requester will appear which prompts you to insert the appropriate media
  1566. into the destination device. There are two gadgets in this requester:
  1567. CONTINUE and ABORT. Clicking the ABORT gadget will return you to the Backup
  1568. Information screen. The message Backup Aborted will be displayed in the
  1569. Backing Up display. From here, click the QUIT BACKUP gadget to return to the
  1570. Ami-Back main screen.
  1571.  
  1572. If instead you wish to go on with the backup, insert the required backup
  1573. media when the requester appears. If you are performing backups to floppy
  1574. disk, the requester will disappear, and the backup process will be initiated
  1575. automatically. However, you will need to select the CONTINUE gadget each
  1576. time if you are performing backups to any other media (tapes, removable hard
  1577. drives, etc.) If the backup media is already in the destination device when
  1578. the requester appears, simply click the CONTINUE gadget and the backup
  1579. process will begin. Thereafter, whenever a media change is required, the
  1580. same requester will appear informing you of the sequence number of media
  1581. required (for example, Disk 1, Disk 2, etc.) and the destination device for
  1582. the media. (When the floppy disks are inserted, the backup will resume
  1583. automatially.)
  1584.  
  1585. It is possible to avoid all of these requesters after the first one by
  1586. "keeping up with" the backup process. This means inserting media (floppy
  1587. disks only) before the program requests it. The Destination Full gauge will
  1588. give you the infromation you need to know when to insert the media before it
  1589. is requested. You may abort the backup process by clicking on the ABORT
  1590. gadget at any time during the backup (aborts after the current file) or by
  1591. clicking on the CANCEL gadget whenever a requester appears.
  1592.  
  1593. BACKUP CATALOG
  1594.  
  1595. If you selected BACKUP CATALOG as one of your backup options, a requester
  1596. that states "Output Backup Catalog" will appear when the backup is
  1597. completed. You will be given the choices of sending the backup
  1598.  
  1599.                                     -54-
  1600.  
  1601. catalog to a printer, a file, or cancelling the operation. Selecting the
  1602. CANCEL gadget at this point means that the catalog will not be printed, not
  1603. that the backup will be cancelled.
  1604.  
  1605. TAPE APPEND
  1606.  
  1607. If you set the Tape Append option in the Tape Drive Configuration window to
  1608. ON, Ami-Back will ask you if you want to append a backup to the end of any
  1609. existsing data on the tape. Otherwise, Ami-Back will simply proceed with the
  1610. backup. If the Tape Append option is OFF, Ami-Back will write over any data
  1611. that is already on the tape.
  1612.  
  1613. BACKUP ERROR LIST
  1614.  
  1615. If any errors occur during the backup on the source device, you will be able
  1616. to RETRY or SKIP the file containing the error. When errors occur on the
  1617. destination media, Ami-Back will ask you if you wish to RETRY writing to the
  1618. possibly defective media or use the Back-Track option to continue the backup
  1619. by replacing the defective media. When you replace the defective media using
  1620. BACK-TRACK, Ami-Back will rewrite onto the newly inserted media any data
  1621. that was written to the defective media prior to finding the error. This way
  1622. the sequence of the backup process is the same as if there were no error
  1623. detected at all. The total number of disks required for the backup remains
  1624. unchanged.
  1625.  
  1626. SAVING ERROR LISTS
  1627.  
  1628. Ami-Back allows you to save the error list (so that you may, for example,
  1629. print it out for examination later). If errors occur during the backup, a
  1630. requester will appear at the end of the backup asking you if you wish to
  1631. save the error list to an ASCII file. Selecting YES will bring up a file
  1632. requester allowing you to save the error file. If you do not specify a name
  1633. or path, the default filename will be AMIBACKERR.FILE, and the default path
  1634. will be the current path for the Ami-back index files. (If the file
  1635. AMIBACKERR.FILE already exists, the new error list file will be appended to
  1636. the file.)
  1637.  
  1638.                                     -55-
  1639.  
  1640. COMPLETING THE BACKUP
  1641.  
  1642. After your backup is completed, the BEGIN BACKUP and ABORT gadgets will
  1643. become ghosted. At this point, the only available gadget will be the QUIT
  1644. BACKUP gadget on the lower right of the screen. Selecting this gadget will
  1645. return you to the main program screen.
  1646.  
  1647. EXITING THE BACKUP
  1648.  
  1649. To exit Ami-Back, select the QUIT gadget at the main program screen, or
  1650. select the QUIT menu option under the Project menu heading at the main
  1651. screen (the keyboard equivalent of Right Amiga-"Q" will also quit the
  1652. program).
  1653.  
  1654. SELECTIVE
  1655.  
  1656. When this backup option is selected, Ami-Back will perform a search of the
  1657. source device in the same manner as for a Complete backup. Once this is
  1658. completed, the Selective Backup window will display the directory and file
  1659. (including filesize) listing of the source device. The directory/file
  1660. display has a scrolling gadget which enables you to access all directories
  1661. and files if there are too many to view at once.
  1662.  
  1663. The default condition for this mode is to exclude whatever you select. The
  1664. MARK TO EXCLUDE gadget, however, can be cycled to let you MARK TO INCLUDE
  1665. whatever you select.
  1666.  
  1667. If you mark a directory, all the subdirectories and files under the
  1668. directory will be marked. A single click of the left mouse buton will select
  1669. a file or directory, while a double click will take you into the specified
  1670. directory. At the top of the directory listing display is the path of the
  1671. current directory location within the source device directory structure. To
  1672. move back to a higher directory, select the PARENT gadget. Once you reach
  1673. the root of your directory structure, the PARENT gadget will have no effect.
  1674. Double clicking the path display box or the far left border of the
  1675. file/directory display operates the same as the PARENT gadget.
  1676.  
  1677. If any file within a directory is marked, the directory will appear as
  1678. marked.
  1679.  
  1680.                                     -56-
  1681.  
  1682. To select all files and directories under the current path location, select
  1683. the MARK ALL gadget. Selecting the CLEAR ALL gadget will clear all the files
  1684. and directories under your present path location.
  1685.  
  1686. Once you have selected or cleared the files you wish to include or exclude,
  1687. click the CONTINUE gadget to proceed with the backup. Clicking the CANCEL
  1688. gadget will return you to the main program screen.
  1689.  
  1690. 911-RECOVERY
  1691.  
  1692. Ami-Back is truly a complete solution to your data archival needs. One of
  1693. the main reasons to backup your data is to minimize the trouble caused by a
  1694. hard drive failure. When Ami-Back performs a recovery backup, it searches
  1695. the source device to recover as much lost data as possible. It is
  1696. recommended that you find the cause of your hard drive error before
  1697. restoring recovered data. (In most cases reformatting the device will be
  1698. sufficent.)
  1699.  
  1700.                                     -57-
  1701.  
  1702. PERFORMING RESTORES
  1703. ----------------------------------------------------------------------------
  1704.  
  1705. Ami-back gives you these options for restoring your backed up data:
  1706. Complete, Selective, Compare, Image, and Build Index. The Compare and Build
  1707. Index modes do not actually perform restores; Compare will make a
  1708. comparison between your backed-up data and the data currently on your hard
  1709. disk, and Build Index recreates an index for backed-up data if for some
  1710. reason the original index is not available to you. If you selected the SHOW
  1711. CONFIGURATION FIRST option in the Program Configuration window, Ami-Back
  1712. will immediately display the Restore Configuration allowing you to continue
  1713. with the restore.
  1714.  
  1715. COMPLETE
  1716.  
  1717. To perform a complete restore, make sure that you have set your Restore
  1718. Configuration options properly. Then, from the main program window, select
  1719. the RESTORE gadget (or the R keyboard equivalent) to begin the restore
  1720. process.
  1721.  
  1722.                                     -59-
  1723.  
  1724. When you direct Ami-Back to perform a restore, the Restore Information
  1725. screen will be displayed. (Notice the similarity to the Backup Information
  1726. screen.) Under the Restore Configuration heading you will see the source and
  1727. destination devices to be used, and the type of restore to be performed will
  1728. also be displayed.
  1729.  
  1730. Selecting the BEGIN RESTORE gadget will start the restore. This will bring
  1731. up a requester telling you to insert the first media into the source device.
  1732. (You may click the CANCEL gadget to abort the restore process. If you do
  1733. this, you must then click QUIT RESTORE on the Restore Information screen to
  1734. return to the program main screen.) After you insert the media, the number
  1735. of Files and Bytes Estimated will be updated from their initial values of
  1736. zero.
  1737.  
  1738. Inerting the requested media will automatically initiate the restore
  1739. process. Ami-Back will prompt you each time a media change is required
  1740. during the restore process. Just as with the backup process, you may avoid
  1741. these prompts if you are using multiple source devices by anticipating or
  1742. "keeping up" with the floppy disk changes (when using other media the
  1743. requester will alwats appear to prompt you for a media change). To abort the
  1744. restore at any time, select the ABORT gadget.
  1745.  
  1746. When using tape media, be sure to allow for completion for the tape
  1747. retension pass before proceeding with the backup. Also, DAT drives with Fast
  1748. Search capability are automatically detected.
  1749.  
  1750. If the File Detection option (set in the Restore Configuration window)
  1751. instructs Ami-Back to WRITE-OVER existing files of the same name from the
  1752. backed-up data. The WRITE-OVER (DATE) option ensures that if the backed-up
  1753. files have a later date than the corresponding files on the destination, the
  1754. files will be overwritten. If the SKIP-OVER option is selected, duplicate
  1755. files will not be restored. Instead, the duplicate files will be entered
  1756. into the error list as having been skipped. When the restore is complete, a
  1757. requester will appear asking you if you wish to "Save contents of list." You
  1758. may select either the YES or the NO gadget. If the File Detection option is
  1759. set to RENAME, you will be able to rename the file to which your restore
  1760. data is written whenever a duplicate file is encounteered. Any time a
  1761. duplicate file is encountered, a requester which states "Enter new file
  1762. name" will appear. You will see a string gadget with the current filename.
  1763. To specify a new filename, type the new new filename (the string gadget is
  1764. activated automati-
  1765.  
  1766.                                     -60-
  1767.  
  1768. cally), then press the RETURN key or click the RENAME gadget. The file will
  1769. be written to the new name. If you specified the same name, the file will be
  1770. over-written. (Renamed files will be written to the same directory where the
  1771. originals are located.) This requester also lets you ABORT the restore or
  1772. SKIP-OVER the curreent file by selecting the appropriate gadget. (Once
  1773. again, when SKIP-OVER is selected, the file will be entered into the error
  1774. list.)
  1775.  
  1776. Under the Restore Information heading you will find the same information
  1777. displays as are on the Backup Information screen. The Restoring display
  1778. shows the file currently being restored to the specified Destination. The
  1779. Actual Disks heading tells you what number media is being restored. The
  1780. Restore Complete and Source Read gauges keeps you informed of the percentage
  1781. progress of the restore. During restores with tape drives you will not be
  1782. given this information. (There is no accurate way of determining the actual
  1783. length of the tape in use without testing it first.)
  1784.  
  1785. MULTIPLE DEVICE RESTORES
  1786.  
  1787. It is possible to perform selective restores from multiple-device backups.
  1788. If you perform a multiple-device backup and you want to selectively restore,
  1789. you must enter the same number devices to restore to as you backed up from,
  1790. and you must enter them in the correct order. You may "fool" the program if
  1791. you want to restore only several files or directories to a single device
  1792. instead of to multiple devices. To do so, enter the same device name more
  1793. than once. For example, if you backed up partitions WB_2.X: and WORK:, and
  1794. you wanted to restore a few files from each partition to RAM:, enter in the
  1795. restore destination gadget RAM: RAM:. This provides two device names
  1796. (satisfying program requirements) while restoring to one device. If, for
  1797. example, you backed up WB_2.X: and WORK:, and you assigned DH0: to WB_2.X:
  1798. and DH1: to WORK:, you may use those assignment names when restoring. This
  1799. will change your device list on the selective restore to DH0: and DH1:.
  1800.  
  1801. TAPE APPEND
  1802.  
  1803. If several backups are appended on a tape, Ami-Back will ask you if you
  1804. want to restore each consecutive backup until you select the YES gadget or
  1805. the last backup on tape is reached. If you want to restore all the existing
  1806. backups on tape using the current restore configuration, click
  1807.  
  1808.                                     -61-
  1809.  
  1810. on the ALL gadget instead of the YES gadget. (This is primarily useful for
  1811. tapes with several incremental backups of the same device.) When performing
  1812. selective restores Ami-Back will automatically find the correct backup. If
  1813. the TAPE APPEND option is not selected, Ami-Back will restore the first
  1814. backup on the tape should more than one backup exist on the tape.
  1815.  
  1816. ERRORS ENCOUNTERED DURING THE RESTORE
  1817.  
  1818. If errors are found on the source or the destination media, you will be
  1819. given the opportunity to RETRY reading the file or to SKIP the current file
  1820. and search for the next available file to be restored. If errors exist on
  1821. your hard disk drive, it is recommended that you ABORT the restore process
  1822. as soon as possible and repair the hard drive by reformatting it, or map out
  1823. the bad blocks using the software provided with your controller. Once you
  1824. have done this, it is all right to perform the restore.
  1825.  
  1826. SAVING ERROR LISTS
  1827.  
  1828. Any errors that occur during the restore will be updated to the Rstore Error
  1829. list in the same manner as done during backup. You will be able to save this
  1830. list to an ASCII text file.
  1831.  
  1832.                                     -62-
  1833.  
  1834. A requester will appear at the end of the backup asking you whether you wish
  1835. to save the error list. If you select YES, a requester will appear for you
  1836. to specify a path and name for saving the errorlist. If you do not specify a
  1837. name or path, the default filename will be AMIBACKERR.FILE, and the default
  1838. path will be the current path for the Ami-back index files. (If the file
  1839. AMIBACKERR.FILE already exists, the new error list file will be appended to
  1840. the file.)
  1841.  
  1842. COMPLETING THE RESTORE
  1843.  
  1844. After your restore is completed, the BEGIN RESTORE and ABORT gadgets will
  1845. become ghosted, and the only available gadget will be the QUIT RESTORE
  1846. gadget. Selecting this gadget will return you to the main program screen.
  1847.  
  1848. EXITING THE RESTORE
  1849.  
  1850. To exit Ami-Back, select the QUIT gadget at the main program screen, or
  1851. select the QUIT option under the Project menu heading at the main screen
  1852. (the keyboard equivalent of Right Amiga-"Q" will also quit the program).
  1853.  
  1854. SELECTIVE RESTORE
  1855.  
  1856. When the restore type you have chosen is Selective, Ami-Back will prompt you
  1857. with a Select Index File requester before starting the restore. Here you
  1858. must select a specific index file so that Ami-Back will be able to load and
  1859. display a tree-structured directory of the backed up information. When using
  1860. this option in the AmigaDOS 2.0 version of the program, the file requester
  1861. will bring up only files with the .IDX suffix.
  1862.  
  1863. Each index is connected to a specific backup by datestamp. For each set of
  1864. backed-up data you have, you should also have a particular index file. You
  1865. cannot perform a selective restore with an incorrect index file. If you do
  1866. not have an index file, you will only be able to perform a complete restore
  1867. of your data unless you rebuild the index.
  1868.  
  1869. Clicking the SELECT gadget in the index file requester (after you have
  1870. chosen the index file) will bring up the Selective Restore screen. The
  1871. layout and operation of the Selective Restore screen is exactly the same as
  1872.  
  1873.                                     -63-
  1874.  
  1875. that of the Selective Backup screen. After you have selected the files you
  1876. wish to restore, clicking the CONTINUE gadget will start the restore, and it
  1877. will proceed in the same way as a Complete restore.
  1878.  
  1879. COMPARE MODE
  1880.  
  1881. The Compare mode does not actually perform a restore. Rather, it allows you
  1882. to find differences between the backed-up data and the data currently on
  1883. your hard disk drive. This function is extremely useful when you are
  1884. concerned that something may have happened to affect the integrity of the
  1885. data on your hard drive (such as a hard drive "crash"). Ami-Back allows you
  1886. to select the Compare information you wish to have reported by selecting the
  1887. appropriate gadgets. These are the options available.
  1888.  
  1889. Check option:
  1890.  
  1891. FILE EXIST - Check to see if File Exists
  1892. DATA - If exists will compare data between files
  1893. TIME/DATE STAMP - If exists will compare file datestamps
  1894. PROTECTION BITS - If exists will compare protection bits
  1895. FILE COMMENT - If exists will compare file comments
  1896.  
  1897.                                     -64-
  1898.  
  1899. When the Compare restore is initiated, you will be presented with the
  1900. Compare Information window. You will be shown the Source and Destination
  1901. devices as well as information on the number of Files and number of Bytes
  1902. these files occupy on the backed-up media.
  1903.  
  1904. The Compare Error List displays any erros found during the data comparison.
  1905. (The scroll gadget allows you to view all the contents of the list if there
  1906. are too many errors to display at once.) The following is a table which
  1907. lists and explains the possible messages that the Compare mode will return.
  1908.  
  1909.    MESSAGES              EXPLANATION
  1910.    -----------------------------------------------------------------
  1911.    DATA DIFFER           change in contents of file
  1912.    DATE                  change in datestamp of file
  1913.    FILE DOESN'T EXIST    file no longer exists on destination device
  1914.    NOTE                  change in file note
  1915.    PROTECT               change in file protection bits
  1916.    READ ERROR            error in reading destination device
  1917.  
  1918. The list entries will be displayed on a single line which indicates the
  1919. file's path. Multiple messages will be seperated by the "/" character. For
  1920. example, the entry
  1921.  
  1922.    SYS:C/DIR             DATE/PROTECT/NOTE
  1923.  
  1924. means that the datestamp, the protection bits, and the file note of the DIR
  1925. file in the SYS:C directory have been altered since the backup was
  1926. performed.
  1927.  
  1928. When the comparison is complete, a requester which states "Save contents of
  1929. list" will appear, giving you the option to save the Compare Error Lits to a
  1930. file. Selecting the NO gadget will return you to the Compare Information
  1931. window, and from there you may select the QUIT COMPARE gadget to return to
  1932. the main program screen. Selecting thee YES gadget will bring up a requester
  1933. which will allow you to save the list to an ASCII text file you specify. If
  1934. you do not specify a file, the list will be saved to AMIBACKERR.FILE in the
  1935. SYS:S directory. After you have saved the list, you will be returned to the
  1936. Compare Information screen where you may select the QUIT COMPARE gadget to
  1937. return to the main program screen.
  1938.  
  1939.                                     -65-
  1940.  
  1941. IMAGE
  1942.  
  1943. Ami-Back can restore an exact image of your backed-up data. You must restore
  1944. your data to a partition that is the exact same size as the source you
  1945. selected for backup. If the partition is not the right size, Ami-Back will
  1946. prompt you, giving you the number of blocks required for the destination
  1947. device. It is not possible to perform incremental restores under the Image
  1948. restore option. When restoring from a multiple-device Image backup (as with
  1949. other multiple-device backups) you must enter the device names in the order
  1950. in which they were backed up.
  1951.  
  1952. BUILD INDEX
  1953.  
  1954. During backups, Ami-Back creates an index that can be used later to
  1955. selectively restore data. It is possible for an index to be in some way
  1956. lost. If this happens, you can always perform a complete restore, or you may
  1957. build a new index file for your backed-up data. You must first select the
  1958. BUILD INDEX restore option, then perform a restore in the same manner as
  1959. complete restore. This will not restore any files. At the end of the
  1960. rebuild, you will have the opportunity to name the new index file. Be sure
  1961. to give the new file a name with a .IDX suffix.
  1962.  
  1963.                                     -66-
  1964.  
  1965. RUNNING AMI-SCHED
  1966. ----------------------------------------------------------------------------
  1967.  
  1968. Ami-Sched allows you to schedule the times you desire to perform backups and
  1969. carries out the task of performing the backups with no action required on
  1970. your part (except for media changes, should they be necessary). Ami-Sched
  1971. was designed and written so as to occupy as little processor time as
  1972. possible. Therefore, you should feel free to place Ami-Sched in your
  1973. startup-sequence file and let it run at all times. Ami-Sched will not
  1974. degrade multitasking performance on your Amiga!
  1975.  
  1976. Ami-Sched is easy to start and stop. Run the program (from Workbench or the
  1977. shell), and a small status window will appear for 2 seconds. In it will be
  1978. some copyright information, and also it will tell the user if the it is
  1979. starting or aborting. The program "wakes up" once each minute to see if any
  1980. of the schedule configuration times are met. It will also wake up if the
  1981. AMI-BACK.CONFIG file is modified. If it is modified, a log entry will be
  1982. made (if the scheduler is running).
  1983.  
  1984. The Schedule Configuration in Ami-Back works with Ami-Sched, and allows you
  1985. to schedule backups to take place at certain times without you having to
  1986. actually run Ami-Back. The backup will run as a background task, only
  1987. requiring interaction if a media change is required.
  1988.  
  1989. The configuration sets up the times the backup for the backup to be
  1990. executed. The default time is 12:00 AM (00:00 or midnight). (This is only
  1991. true when the backup is initiated.
  1992.  
  1993. SCHEDULER OPTIONS
  1994.  
  1995. If you use Ami-Back on a frequent basis, it is recommended that you execute
  1996. Ami-Sched every time you turn your Amiga on. This should be done by typing
  1997. RUN>NIL:[PATH]AMI-SCHED on a single line in your startup-sequence file. The
  1998. >NIL: operator allows you to terminate the Shell. In other words, it
  1999. detaches the program from the Shell to run a seperate task.
  2000.  
  2001.                                     -67-
  2002.  
  2003. To stop the scheduler you just run it again from either the Shell or
  2004. Workbench. You will get the message "ABORTING" on a small window (which is
  2005. displayed for two seconds) informing you that the operation of Ami-Sched has
  2006. been terminated. It is possible to suppress the display of this information
  2007. window by running the scheduler (from the Shell or your startup-sequence)
  2008. with the NOMESSAGE option. To make use of this option, type
  2009. RUN>NIL:[PATH]AMI-SCHED NOMESSAGE at the shell prompt or in your
  2010. startup-sequence file. This option will prevent the two second Ami-Sched
  2011. display window.
  2012.  
  2013.                                     -68-
  2014.  
  2015. PERFORMING BACKUPS FROM THE SHELL
  2016. ----------------------------------------------------------------------------
  2017.  
  2018. For users who prefer to operate their programs from the Amiga's Shell,
  2019. Ami-Back supports the standard CLI (Command Line Interface) options as
  2020. defined by AmigaDOS.
  2021.  
  2022. You can use the NOWINDOWS option. This allows you to run Ami-Back without
  2023. opening any windows as a background task from the Shell. All information
  2024. (errors, etc.) will be updated to the AMI-BACK.LOG file. The only time you
  2025. will be notified is when media changes are required. Be sure to remember
  2026. that the first media required will be assumed to be in the proper
  2027. destination device when the program is run as a background task. All Shell
  2028. options may be specified as tooltype options from the program icon. See the
  2029. following section on tooltypes for more information.
  2030.  
  2031. You may start Ami-Back with a different configuration file by using the CLI
  2032. option CONFIG=. For example, typing
  2033.  
  2034.     AMI-BACK CONFIG=SYS:S/AMI-BACK.CONFIG2
  2035.  
  2036. will run the program with the configuration file you have selected. When
  2037. running Ami-Back13 (the version for AmigaDOS 1.3), type a space character
  2038. instead of "=" after CONFIG like this:
  2039.  
  2040.     AMI-BACK CONFIG SYS:S/AMI-BACK.CONFIG2
  2041.  
  2042. You can perform all backups except for Selective when using the NOWINDOWS
  2043. option.
  2044.  
  2045. When you use the NOWINDOWS option from the Shell, you may specify a backup
  2046. source device that is different from the device you specified in setting up
  2047. the backup configuration. This can be done by using the SOURCE= option.
  2048. (This feature only works in conjunction with the NOWINDOWS options.) In this
  2049. way, it is not neccessary to run Ami-Back to change your backup
  2050. configuration. For example, if you wished to specify your DH1: partition as
  2051. your backup source device, you would execute Ami-Back by entering RUN
  2052. AMI-BACK NOWINDOWS SOURCE=DH1: at the Shell prompt (upper-case letters not
  2053. neccessary).
  2054.  
  2055.                                     -69-
  2056.  
  2057. OTHER FEATURES
  2058. ----------------------------------------------------------------------------
  2059.  
  2060. KEYBOARD EQUIVALENTS
  2061.  
  2062. You can access many of Ami-Back's features without using the mouse. For
  2063. example, to begin a backup or restore, to access the scheduler, or to quit
  2064. from the opening screen, simply press the B, R, S, or Q key. The keyboard
  2065. equivalents allow you to select from all the backup and restore
  2066. configuration options (as described in the following sections). For example,
  2067. pressing the B key while in the backup configuration mode selects each
  2068. backup type in turn. By using keyboard equivalents, you can select your
  2069. configuration options without using the mouse.
  2070.  
  2071. PASSWORD PROTECTION
  2072.  
  2073. Password protection is an option that you may wish to select if your data is
  2074. sensitive or important enough for restricted access. If you have specified
  2075. the Password Protection in your Backup Configuration, during the backup
  2076. process you will be asked to supply a password, and you will be asked to
  2077. supply this same password when you wish to restore the data. It is
  2078. impossible to restore protected data without supplying the password, so be
  2079. sure that you do not lose or forget the password you select.
  2080.  
  2081. ONLINE HELP
  2082.  
  2083. Ami-Back provides Online Help (through the Commodore AmigaGuide system) for
  2084. the major program gadgets. To obtain help, place thee mouse pointer over the
  2085. desired gadget and press the HELP key. For example, place the mouse cursor
  2086. ovr the RESTORE gadget on the main screen, then press the HELP key. A window
  2087. titled "Restore_Gadget" will appear. There will be several selectable
  2088. gadgets in this window as well as some basic information about the RESTORE
  2089. gadget. Click on the CONTENTS gadget to display a table of contents of the
  2090. Ami-Back help information available. The RETRACE gadget will take you back
  2091. to the previous screen, and the two BROWSE gadgets will allow you to step
  2092. through the help information in sequential order, either forward or
  2093. backward. Select the HELP gadget for more information on the AmigaGuide help
  2094. system.
  2095.  
  2096.                                     -71-
  2097.  
  2098. AREXX
  2099.  
  2100. You may communicate with Ami-Back through the AMIBACKREXX port. The
  2101. functions BACKUP, RESTORE, LOAD and QUIT are supported. Ami-Back can be put
  2102. in rexx server mode by the REXXSERV command line argument or tooltype
  2103. switch. This will cause Ami-Back to wait for AREXX commands before
  2104. performing operations. A sample AREXX script is supplied on the program
  2105. disk called ABSCRIPT.REXX. This script demonstrates how to use the
  2106. Ami-Back AREXX port.
  2107.  
  2108. HARD AND SOFT LINKS
  2109.  
  2110. Ami-Back supports Hard and Soft links under AmigaDOS 2.0. Here are some
  2111. notes applicable to backing up or restoring linked files and directories. If
  2112. you perform a selective backup with a link file or directory in your source
  2113. device, you will see "link" in the right-most part of the file or directory
  2114. name. During restore operations these links will be re-established if the
  2115. actual directory or file that the link file linked to exists.
  2116.  
  2117. Hard links cannot be made across devices, so they are restored relative to
  2118. the destination device. For example, a link from DH0:S/LINK to
  2119. DH1:OTHER/TEST when restored to RAM: would result in a link from RAM:S/LINK
  2120. to DH1:OTHER/TEST.
  2121.  
  2122. See your AmigaDOS manual for more information on links and how to use them.
  2123.  
  2124. DISPLAY OPTIONS
  2125.  
  2126. SNAPSHOT - There is a SNAPSHOT option under the Project menu available from
  2127. the Ami-Back20 opening screem (only available in the Workbench screen mode).
  2128. This allows you to specify where on your Workbench window you wish Ami-Back
  2129. to appear when run. To use,
  2130.  
  2131.                                     -72-
  2132.  
  2133. just select the program main window drag bar and move it to the location you
  2134. want Ami-Back to appear. Then select the SNAPSHOT option. This will save the
  2135. location to the current program configuration. This option is convenient for
  2136. users who operate in PAL mode, overscan, or have larger than default
  2137. Workbench screens.
  2138.  
  2139. ZOOM GADGET - Clicking on the Zoom gadget (only available in the Workbench
  2140. screen mode) will reduce the Ami-Back window to a drag bar. If Ami-Back
  2141. needs to notify you of a required media change, a Workbench requestor will
  2142. appear. If any errors occur during the backup or restore, Ami-Back will
  2143. expand back to its full-sized window. When Ami-Back is reduced to a drag
  2144. bar, the percentage complete of the backup or restore and the percentage of
  2145. the destination full (if applicable) will be displayed.
  2146.  
  2147. SCREEN MODES - The Ami-Back window can open to either your Workbench window
  2148. or a Custom window of 640 x 200 pixels. To choose a window type, select
  2149. either WORKBENCH or CUSTOM under the screen item of Preferences in the main
  2150. screen menu.
  2151.  
  2152. ICON TOOLTYPE OPTIONS
  2153.  
  2154. You may use the tooltype CONFIG to start Ami-Back with different
  2155. configuration files when running from Workbench. For example:
  2156.  
  2157.    CONFIG=SYS:S/AMI-BACK.CONFIG2
  2158.  
  2159. This will run the program with the configuration file you have selected.
  2160.  
  2161. The same tooltype option exists in Ami-Sched (also in shell command line).
  2162. This works the same as Ami-Back's config option. This allows Ami-Sched to
  2163. use different configurations.
  2164.  
  2165. In addition to the tooltype CONFIG, you may also use the tooltype
  2166. "NOWINDOWS." By adding this tooltype, the program will run in the
  2167. background. There will be no windows opened. This works the same as doing a
  2168. bakground backup from shell.
  2169.  
  2170.                                     -73-
  2171.  
  2172. The NOMESSAGE tooltype is available to Ami-Sched. This works the same as the
  2173. shell command line option. It prevents the Starting/Aborting message window
  2174. from coming up during these operations.
  2175.  
  2176. When using NOWINDOWS and NOMESSAGE tooltypes in the AmigaDOS 1.3 version of
  2177. Ami-Back or Ami-Sched, you need to use an "=" after NOWINDOWS or NOMESSAGE.
  2178. For example, "NOWINDOWS=" is proper.
  2179.  
  2180.                                     -74-
  2181.  
  2182. APPENDIX I
  2183. ----------------------------------------------------------------------------
  2184.  
  2185. QUESTION AND ANSWER
  2186.  
  2187. Q: Do I have to format my floppy disks before I can back up to them?
  2188. A: Only if your destination is an AmigaDOS file.
  2189.  
  2190. Q: Do I need any special drivers in order to use my tape drive?
  2191. A: No. SCSI tape drives are supported directly by Ami-Back.
  2192.  
  2193. Q: I lost my backup index file. Is this a problem?
  2194. A: No. You can still perform a complete restore, or you can use the
  2195.    Build Index option to create a new index.
  2196.  
  2197. Q: I've specified the Compression option for my backups, but I don't
  2198.    seem to be saving any space. Why not?
  2199. A: If Ami-Back encounters any files during the backup that have already
  2200.    been compressed efficently (so that only an additional 10% or less
  2201.    would be saved), it will not try to compress those files any further.
  2202.    Most likely, your files have already been compressed.
  2203.  
  2204. Q: I've forgotten the password to a backup that I made with the
  2205.    password option. How can I restore the data?
  2206. A: You can't. (Password protection is real protection - the password
  2207.    is essential!)
  2208.  
  2209. Q: I backed up my data with an older version of Ami-Back. Will this
  2210.    version restore my data all right?
  2211. A: Yes. But make sure you delete the old Ami-Back.config file.
  2212.  
  2213. Q: Can I run more than one copy of Ami-Back at a time?
  2214. A: No, even though Ami-Back is a multitasking program. Ami-Back contains
  2215.    an AMIBACKFIFOPORT which allows only one copy of the program to run
  2216.    at a time, and this prevents problems with multi-scheduled events.
  2217.  
  2218.                                     -75-
  2219.  
  2220. Q: I have Ami-Sched running, but Ami-Back doesn't backup when it's supposed
  2221.    to. What's wrong?
  2222. A: When this occurs, 9 times out of 10, the Scheduler Configuration is
  2223.    improperly set. Also, you want to be sure the program path is entered
  2224.    correctly (path including program name) in the Program CConfiguration
  2225.    window.
  2226.  
  2227. Q: If I use the compression option during backup, will Ami-Back be able to
  2228.    find a file in a selective restore without having to search through all
  2229.    my data disks?
  2230. A: Yes, in fact, Ami-Back will immediately prompt you for the correct data
  2231.    disk to insert.
  2232.  
  2233.                                     -76-
  2234.  
  2235. APPENDIX II
  2236. ----------------------------------------------------------------------------
  2237.  
  2238. HARDWARE CCONFIGURATIONS
  2239.  
  2240. The following is a lsit of hard drive controllers and tape drives with
  2241. which Ami-Back has been tested.
  2242.  
  2243. CONTROLLER
  2244.  
  2245.    Commodore A3000 controller
  2246.    Commodore 2091
  2247.    ICD AdSCSI
  2248.    IVS Grandslam
  2249.    IVS Trumpcard
  2250.    GVP Series II
  2251.    Microbotics Hardframe
  2252.    Supra Wordsync
  2253.  
  2254. DRIVE
  2255.  
  2256.    Archive Python DAT drive
  2257.    Archive Sidewinder 250
  2258.    Archive Viper 2525s
  2259.    Commodore 3070
  2260.    Hewlet Packard DAT drive
  2261.    Xybyte 8mm (2.3 Gigabytes)
  2262.    Sony DAT drive
  2263.    Tallgrass TG-4040 (direct access)
  2264.    Tandberg TDC-3600 (with some controllers only)
  2265.    Tandberg TDC-3600 (with some controllers only)
  2266.    Tandberg 3640
  2267.    Teac MT-2ST
  2268.    3M MCD-40 (direct access)
  2269.    Wangtek 5125
  2270.    Wangtek 5150es
  2271.    Wangtek 5525es
  2272.    Wangtek 6200 DAT
  2273.    Wangtek SCSI-36
  2274.  
  2275.                                     -77-
  2276.  
  2277. APPENDIX III
  2278. ----------------------------------------------------------------------------
  2279.  
  2280. TIPS AND TRICKS
  2281.  
  2282. PAUSING BACKUPS
  2283.  
  2284. If you need to pause the backup process (a backup may be in progress and you
  2285. may want to update a file without aborting then restarting the backup), you
  2286. may select the ABORT gadget at any time after beggining the backup. A
  2287. requestor will appear asking you "Are you sure you want to abort?" As long
  2288. as you do not respond to this requestor the backup will be suspended. When
  2289. you are ready to resume the backup process, simply select the NO gadget.
  2290. (Selecting the YES gadget will abort the backup.)
  2291.  
  2292. USING AMI-BACK TO TRANSFER DATA BETWEEN MACHINES
  2293.  
  2294. Ai-Back is a useful tool for transfering data between computers as well as
  2295. simply backing up data. You may use the compression option to backup your
  2296. data to as few floppy disks as possible, or you may use any other media that
  2297. Ami-Back supports for the backup. Then, using the same media, restore the
  2298. data from the destination machine. This method has the advantage of
  2299. maintaining the complete directory structure from the source computer.
  2300.  
  2301. DEFRAGMENTING YOUR HARD DISK
  2302.  
  2303. Ami-Back already gives you a compelling reason not to purchase a disk
  2304. utilities program: Ami-Back is capable of recovering data lost on hard
  2305. drives. Another disk utilities function that Ami-Back can also handle is the
  2306. task of optimizing your hard drive. To do so, simply back up the data on
  2307. whichever partitions that you wish to defragment and thereby optimize. When
  2308. this is done, reformat the backed up partition. Then, restore the data to
  2309. the hard drive partition.
  2310.  
  2311.                                     -79-
  2312.  
  2313. APPENDIX IV
  2314. ----------------------------------------------------------------------------
  2315.  
  2316. ERROR MESSAGES
  2317.  
  2318. FLOPPY DISK DRIVE ERRORS
  2319.  
  2320. (Most of these errors indicate that something is wrong with the data on the
  2321. disk.)
  2322.  
  2323. Error Code        Explanation
  2324.  
  2325.     20            a general error
  2326.     21            Ami-Back couldn't find a sector header.
  2327.     22            A sector looked wrong.
  2328.     23            A sector looked wrong
  2329.     24            A sector header had an incorrect checksum
  2330.     25            Sector data had an incorrect checksum
  2331.     26            Ami-Back couldn't find enough sectors
  2332.     27            Sector header is bad.
  2333.     28            Can't write to a protected disk.
  2334.     29            There is no disk in the drive.
  2335.     30            Ami-Back couldn't find track 0.
  2336.     31            Ami-Back ran out of memory.
  2337.  
  2338. SCSI TAPE DRIVE ERRORS
  2339.  
  2340. Error Code        Explanation
  2341.  
  2342. Self Unit         Attempted to send a command to "ourselves"
  2343.                   (i.e., Unit is set to that of the controller).
  2344.  
  2345. DMA Error         Erorr occured while the controller was trying to
  2346.                   DMA data to/from memory.
  2347.  
  2348. Bad SCSI Phase    Controller is having problems communicating with drive.
  2349.  
  2350. SCSI Parity Error Parity error between controller and drive.
  2351.  
  2352. Recovered Error   Indicates that the last command completed successfully
  2353.                   with some recovery action performed by the target.
  2354.                   Details may be determinable by examining the additional
  2355.                   sense bytes and the information bytes.
  2356.  
  2357.                                     -81-
  2358.  
  2359. Error Code        Explanation
  2360.  
  2361. Select Timeout    Controller timed out while trying to send command to
  2362.                   drive.
  2363.  
  2364. Not Ready         Indicates that the logical unit addressed cannot be
  2365.                   accessed. Operator intervention may be required to
  2366.                   correct this sitution.
  2367.  
  2368. Medium Error      Indicates that the command terminated with a non-
  2369.                   recovered error condition that was probably caused
  2370.                   by a flaw in the medium or an error in the recorded
  2371.                   data.
  2372.  
  2373. Hardware Error    Indicates that the target detected a non-recoverable
  2374.                   hardware failure (for example, controller failure,
  2375.                   device failure, parity error, etc) while performing
  2376.                   the command or during a self test.
  2377.  
  2378. Illegal Request   Indicates that there was an illegal parameter in the
  2379.                   command descriptor block or in the additional
  2380.                   parameters supplied as data for some commands
  2381.                   (FORMAT UNIT, SEARCH DATA, etc). If the target
  2382.                   detects an invalid parameter in the command
  2383.                   descriptor block, then it shall terminate the
  2384.                   command without altering the medium. If the target
  2385.                   detects an invalid parameter in the additional
  2386.                   parameters supplied as data, then the target may
  2387.                   have already altered the medium.
  2388.  
  2389. Unit Attention    Indicates that the removable medium may have been
  2390.                   changed or the target has been reset.
  2391.  
  2392. Data Protect      Indicates that a command that reads or writes the
  2393.                   medium was attempted on a block that is protected
  2394.                   from this operation. The read or write operation
  2395.                   is not performed.
  2396.  
  2397. Blank Check       Indicates that a write-once read-multiple device or
  2398.                   a sequential-access device encountered a blank block
  2399.                   while reading or a write-once read-multiple device
  2400.                   encountered a non-blank block while writing.
  2401.  
  2402.                                     -82-
  2403.  
  2404. INDEX
  2405. ----------------------------------------------------------------------------
  2406.  
  2407. Adding Filter Parameters  30
  2408. Ami-Back.log file  15
  2409. Ami-Sched  43
  2410. amiback.guide  3,8
  2411. AmigaDOS Files  25,35
  2412. AmigaGuide  71
  2413. amigaguide.library  3
  2414. Appendix IV  81
  2415. Appendix I  75
  2416. Appendix II  77
  2417. Appenidx III  79
  2418. AREXX  72
  2419. asl13.library  3
  2420. Asynchronous operations  17
  2421. Auto Retension  25
  2422. Auto Tape Size  24
  2423. Backup Buffer  24
  2424. Backup Catalog  27,54
  2425. Backup Configuration  19
  2426. Backup Configuration Screen  19
  2427. Backup Destination Device  21
  2428. Backup Error Lost  55
  2429. Backup Filter Configuration Screen  28
  2430. Backup Filter Path  16
  2431. Backup Information Displays  52
  2432. Backup Information Screen  52
  2433. Backup Label  53
  2434. Backup Options  27
  2435. Backup Philosophy  9
  2436. Backup Source  19
  2437. Backup Types  25
  2438. Backup Write Notify  27
  2439. Backups per day  15
  2440. Beta Testers  iii
  2441. Block Size  24
  2442. Block Type  24
  2443. BUAmi-Back.filter  16
  2444. Build Index  37,66
  2445. CLI  69
  2446. Comic Motivation  iii
  2447. Compare Error Messages  65
  2448. Compare Options  64
  2449. Compare Restore Mode  64
  2450. Compare Rstores  36
  2451. Complete Backups  26,51
  2452. Complete Rstores  36,59
  2453. Completing Backups  56 
  2454. Completing Restores  63
  2455. Config Tooltype  73
  2456. Configure Backup Filter  28
  2457. Copy protection  7
  2458. Copyrights  ii
  2459. Credits  iii
  2460. Data Filter  31
  2461. Defragmenting hard disk  79
  2462. Deleting Filter Parameters  30
  2463. Destination Device  33
  2464. Device Types  15
  2465. Direct Access Drives  23
  2466. Directory Structure  38
  2467. Display Alert  16
  2468. Display Options  72
  2469. DMA Activity  17
  2470. Error Messages  81
  2471. Errors During Restores  62
  2472. Event Type  45
  2473. Exiting Backup Configuration  31
  2474. Exiting Backups  56
  2475. Fast File System  26
  2476. Features  11
  2477. File Date  37
  2478. File Protection  38
  2479. File Protection Bits  39
  2480. File/Directory/Comment Filter  29
  2481. Floppy Disk Errors  81
  2482. Floppy Drives  21,35
  2483. Formatting Disks  41
  2484. Formatting Tapes  41
  2485. gadtools.library  3
  2486. Hard Disk Installation  7
  2487. Hard Disk Maintenance  9
  2488. Hard Links  72
  2489. Hardware Configurations  77
  2490. High Density Floppies  21
  2491. I/O Mode  23
  2492. Icon Credits  iii
  2493. Icon Tooltypes  73
  2494. Image Backup  26
  2495. Image Restores  37,66
  2496. Index  83
  2497. Index File Location  17
  2498. Index File Path  15
  2499. Installation  7
  2500. Introduction  1
  2501. Keyboard Equivalents  71
  2502. Kickstart version  5
  2503. Label Backup  27
  2504. License Agreements  ii
  2505. Log file length  15
  2506. Log File Path  15
  2507. MaxTransfer  24
  2508. Media Requirements  41
  2509.  
  2510.                                     -83-
  2511.  
  2512. INDEX
  2513. ----------------------------------------------------------------------------
  2514.  
  2515. Memory requirements  5
  2516. Modifying Filter Parameters  31
  2517. Moonlightr BBS  ii
  2518. Mounted devices  20
  2519. Multiple Configuration Files  46
  2520. Multiple Device Backups  21
  2521. Multiple Device Restores  34,61
  2522. Multiple Scheduler Configurations  45
  2523. Multitasking  9
  2524. NOMESSAGE Tooltype  69
  2525. Online Help  71
  2526. Overview  11
  2527. Package Contents  3
  2528. Package Design  iii
  2529. Password Protection  27,54,71
  2530. Pausing Backups  79
  2531. Performing Backups  51
  2532. Performing Backups from Shell  69
  2533. Performing Restores  59
  2534. Personalization  7,8
  2535. Photo Credits  iii
  2536. Program Configuration  13
  2537. Program Configuration Screen  14
  2538. Program Path  14
  2539. Protection Bit Filter  31
  2540. Question and Answer  75
  2541. Readme!  3
  2542. Recovery (911) Backups  26,57
  2543. Registration Card  3
  2544. Renaming Files  38
  2545. Restore Buffer  24
  2546. Restore Configuration  33
  2547. Restore Destination  33
  2548. Restore File Detection  60
  2549. Restore Filter Configuration Screen  39
  2550. Restore Filter Path  16
  2551. Restore Information Screen  59
  2552. Restore Source  35
  2553. Restore Type  36
  2554. RSAmi-Back.filter  16
  2555. Running Ami-Back  49
  2556. Running Ami-Sched  67
  2557. Saving Backup Error Lists  55
  2558. Saving Restore Error Lists  62
  2559. Scheduler Configuration  43
  2560. Scheduler Configuration Screen  43
  2561. Scheduler Default Settings  46
  2562. Scheduler Example 1  44
  2563. Scheduler Example 2  45
  2564. Sheduler Options  67
  2565. Screen Modes  73
  2566. SCSI Device  23
  2567. SCSI ID  24
  2568. SCSI Tape Errors  81
  2569. Searching Source Device Screen  51
  2570. Selective Backups  26,56
  2571. Selective Backup Screen  57
  2572. Selective Restores  63
  2573. Sequential Access Drives  23
  2574. Shell  69
  2575. Show Configuration First  17,52
  2576. Skip-Over  38
  2577. Snapshot  72
  2578. Soft Links  72
  2579. Special Thanks  iii
  2580. Support  ii
  2581. Synchronous operations  17
  2582. Systeem Requirements  5
  2583. Table of Contents  v
  2584. Tape Append  25
  2585. Tape Append Backups  55
  2586. Tape Append Restores  61
  2587. Tape Buffer  24
  2588. Tape Drive  35
  2589. Tape Drive Configuration Screen  22
  2590. Tape Drive Type  23
  2591. Tape Drive Configuration  22
  2592. Tape Size  24
  2593. Tips and Tricks  79
  2594. Trademarks  ii
  2595. Transfering Data  79
  2596. Updating Ami-Back  7
  2597. Upgrade Policy  ii
  2598. Use Backup Filter  28
  2599. Use Restore Filter  39
  2600. Warranty  ii
  2601. Write-Over  38
  2602. Write-Over (Date)  38
  2603. Zoom Gadget  71
  2604.  
  2605.                                     -84-
  2606.  
  2607.  
  2608. Facts about this doc:  
  2609.  
  2610. Original supplied by Maker, Electronically Reproduced and Fixed to 100%
  2611. (the original was full of errors....) by Baser Evil, 9 hours and 57 minutes
  2612. taken to type the docs, 1 hour 13 minutes reformmating of text and error
  2613. correction, 2 hours miscellaneous time spent fucking off.....  
  2614.  
  2615. See ya in another production!  
  2616.  
  2617. Regards to everyone everywhere that has ever typed a doc, most notably
  2618. Rygar, Pazza, Munchie, Tim-Dog, Scooter, Razor Blade, Michtlantecuhtli,
  2619. Mike, Selim & Rudi, Foxy, Sidewinder, The Southern Starr, and anyone else
  2620. I may have forgotten! (some of these haven't done much in awhile, or even
  2621. in the scene anymore, but they are who comes to mind....)
  2622.  
  2623.                                                Baser Evil
  2624.  
  2625.      ------> The Courts of Chaos - 501-336-9661 - Call it now! <------
  2626.  
  2627.             ------------------------ END ----------------------
  2628.  
  2629.  
  2630.